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Vorwort 


cp/M ist wohl das am meisten benutzte Betriebsystem für Mikro- 
computer mit einer 8080- oder 280-CPU. Es besticht einerseits 
durch die sehr einfache Handhabung, andererseits durch die große 
Menge vorhandener, meist preisgünstiger Programme, die ohne Än- 
derung sofort einsetzbar sind. 


Seit Gary Kildall es im Jahre 1974 der Öffentlichkeit vorstellte, 
hat CP/M immer mehr Freunde gewonnen, wenn auch nicht zu leugnen 
ist, daß für Viele (die meistens von Großrechnern kamen) die 
Oberfläche des Systemes zu dürftig, die Möglicheiten zu gering 
und die Flexibilität zu klein ist. 


Schnell waren zwar Hilfsprogramme (z.B. SHELL) auf dem Markt die 
eine UNIX-ähnliche Umgebung schafften, doch alle Programme dieser 
Art verkleinerten nur die TPA, (den Arbeitsspeicher) die, bei 
CP/M 2 mit einer BIOS-Anpassung für doppelte Dichte, meist sowie- 
so schon zu klein war. 


Mit der Einführung von CP/M 3 (CP/M PLUS) wurden die meisten 
Wünsche der Benutzer erfüllt. Damit hat diese Betriebssystem 
sicher noch erheblich mehr an Bedeutung gewonnen, denn alles geht 
nun wesentlich komfortabler und schneller vonstatten und CP/M 2 
Programme funktionieren noch nach wie vor, wenn auch mit kleinen, 
unbedeutenden Ausnahmen. 


Zu CP/M 2 gibt es mittlerweile eine ganze Menge guter Handbücher 
in deutscher Sprache, zu CP/M 3 bisher noch nicht. Es hieße Eulen 
nach Athen tragen, das x-te Mal über CP/M 2 zu schreiben. 


Aufgabe dieses Buches soll es daher sein vor allem CP/M 3 typ- 
isches herauszustellen, trotzdem soll es auch dem Anfänger als 
Einführung dienen können. 


Es wird für den ernsthaften Benutzer nach wie vor notwendig sein, 
die (englisch-sprachigen) Original-Handbücher von Digital Re- 
search INC, dem Vertreiber von CP/M „ zu haben, um das eine oder 
andere Detail, welches hier nicht ausführlich genug besprochen 
werden konnte, nachzuschlagen. Sicherlich können jedoch in vielen 
Fällen die Beispiel in den Listings die in diesem Buch abgedruckt 
sind (aus einem funktioniernden Gerät) oft weiter helfen. 


Der Aufbau dieses Buches ist bewußt so gehalten, daß der Be- 
nutzer, je nach Wissensstand oder Notwendigkeit immer tiefer in 
die Materie eindringen kann, aber, selbst ohne Vorkenntnisse, 
schnell die wichtigsten Vorteile von CP/M 3 anzuwenden lernt. 


Um den Text durch Querverweise nicht zu unübersichtlich zu 
machen, wurden viele, als allgemein bekannt geltende, Begriffe 
nicht erläutert oder, es werden Begriffe nur kurz angesprochen 
und in einem späteren Kapitel ausführlich erläutert. Im Glossar 
am Ende des Buches steht meist eine genauere Erläuterung oder ein 
Hinweis, wo in diesem Buch Näheres über den gesuchten Begriff zu 
finden ist. 


Zur vollständigen Beschreibung von CP/M 3 gehört auch die Be- 
schreibung des BIOS (Basic Input Output System), der Hardware- 
Anpassung an unterschiedliche Systemvoraussetzungen. 


Es werden alle Notwendigkeiten eines CP/M 3 BIOS beschrieben und 
ein komplettes BIOS-Listing abgedruckt, wobei der NDR-Klein- 
Computer als Hardware dient. Zu diesem Computer steht reichlich 
Literatur zur Verfügung, sodaß eine Besprechnung der dort be- 
nutzten Hardware kein Thema in diesem Buch sein muß. 


wir beginnen in diesem Buch, wenn sich das Betriebssystem erst- 
mals meldet mit: 


CP/M V3.0 Loader 
Copyright (C) 1982, Digital Research 


Sollten Sie, verehrter Leser, (noch) kein funktionierendes Be- 
triebssystem haben, hängt es evtl. (noch) an der Hardware-Anpas- 
sung, dann ist es vielleicht zweckmäßiger die nachfolgende 
Kapitel nur kurz zu "überfliegen' und danach sofort zu Teil IV, 
(Band 2) der Hardware-Anpassung überzugehen. 


Anmerkungen zur Schreibweise: 


Dieses Manuskript wurde mit dem Text-Verarbeitungs-System WORD- 
STAR (R) auf einem ELZET-80 Mikrocomputer geschrieben. 


Unter CP/M werden viele Schriftzeichen benutzt, die im Englischen 
eckige oder geschweifte Klammern darstellen, im Deutschen aber 
für die Umlaute Ä, Ö, Ü reserviert sind. Um trotzdem den Text 
sinnvoll ausdrucken zu können, wurde er zweigeteilt, wobei den 
einen Part teilweise der Computer selbst (mit dem Befehl PUT) 
übernahm, nämlich alles was 'ER' auf die Konsole von sich aus 
ausgeben kann. 


Das eigentliche Manuskript ist mit Umlauten geschrieben, weil es 
sich so doch erheblich besser lesen läßt, alles was aber in den 
Bereich der Kommunikation mit dem Computer fällt, wurde Com- 
Pputergerecht (ohne Umlaute) geschrieben und ist in diesem Buch 
als Ausdruck mit einem Nadeldrucker dargestellt. 


Und da wäre noch das Copyright... 


Alle Listings werden (in unüblicher Weise) KOMPLETT veröffent- 
licht, um die Theorie durch Beispiele und Muster zu untermauern. 
Fehler, Irrtümmer und schlechter Programmierstil sind keineswegs 
ausgeschlossen. 


Das Recht an allen Programmen, auch in veränderter Form, die in 
diesem Buch abgedruckt sind, soweit sie nicht zum Lieferumfang 
von CP/M (R) gehören oder, wie im Falle einfacher Treiberpro- 
gramme, Allgemeingut sind, liegen ausschließlich beim Verfasser. 
Gewerbliche Nutzung und Wiederveröffentlichung bedürfen der 
schriftlichen Abstimmung. 
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Kapitel 1 Der erste Schritt 


Wenn ein CP/M 3 System erst einmal gebootet hat, steht der An- 
fänger meist etwas ratlos vor der lapidaren Meldung: 


B>_ 

und einem daneben blinkenden (oder feststehenden) Cursor. Gibt 
man über die Tastatur einen beliebigen Text ein, so ist das zwar 
möglich, aber rühren tut sich normalerweise nichts. Erst wenn man 
die RETURN-Taste drückt kommt Leben in das System. Das könnte zum 
Beispiel wie folgt aussehen: 


A>mach mal was 


als Antwort folgt, nach kurzem Laufwerksgeklapper. in der näch- 
sten Zeile: 


MACH? 
A> 
Ganz offensichtlich hat CP/M nicht verstanden, was wir wollten, 


Nun zunächst einmal eine Klarstellung: wer uns da 'geantwortet' 
hat, ist ein Teil von CP/M mit dem klangvollen Namen CCP (Console 
Command Prozessor - Konsolen Befehls Ausführer). Mit diesem Pro- 
grammteil haben wir es immer dann zu tun, wenn CP/M kein eigen- 
ständiges Programm abarbeitet. Mehr zu diesem Thema später. 


Hier stellt sich nun die Frage: "wie sag' ich's meinem Kinde?". 


Die Beantwortung ist ganz einfach, der CCP kennt nur zweierlei 
Arten von Befehlen und zwar die "eingebauten! Befehle und Befehle 
die als quasi eigenständige Programme auf der Diskette abgelegt 
sind. Programme dieser Art werden in diesem Zusammenhang als TPA- 
Befehle bezeichnet. 


Die Hauptaufgabe des CCP's ist es, dem Benutzer Hilfestellung bei 
der Verwaltung von Disketten und Dateien zu geben, Hardware- 
Voraussetzungen zu ändern oder umzuschalten (z.B. Drucker. Bild- 
schirmausgabe oder Stellen der Uhrzeit und des Datums usw.) und 
den Zugriff auf beliebige Programme zu ermöglichen. 


Betrachten wir dazu erst einmal die "eingebauten" 


CCP-Befehle: 

DIR Ausgabe des Inhaltsverzeichnis ohne SYS-Dateien 
DIRS Ausgabe des Inhaltsverzeichnis der SYS-Dateien 
ERA Löschen einer Datei aus dem Inhaltsverzeichnis 
REN Umbenennen einer Datei im Inhaltsverzeichnis 
TYPE Ausgeben einer TEXT-Datei auf dem Bildschirm 
USER Umschalten in eine andere Benutzerebene 


Meist können oder müssen dem Befehlswort noch nähere Angaben 
. folgen, wie überhaupt eine strenge Syntax unter CP/M eingehalten 
werden muß; aber darauf kommen wir noch einmal ausführlich zu- 
rück, 


Zuvor wollen wir die zweite Art von Befehlen vorstellen, die 
TPA-Befehle: 


Unter TPA (Transient Programm Area) versteht man einen Spei- 
cherbereich, in den Programme von der Diskette geladen und ausge- 
führt werden; verallgemeinert gesagt der Arbeitsspeicherbereich. 


Unter CP/M 3 sind die eingebauten Befehle DIR, ERA, REN und TYPE 
zusätzlich als TPA-Programme vorhanden, tauchen in unserer Zu- 
sammenstellung also zweimal auf. Dies ist aber lediglich eine 
Option, wenn besondere "Leistungen! von den eingebauten Befehlen 
verlangt werden. Ist der entsprechende TPA-Befehl nicht auf der 
Diskette, wird ganz einfach die "besondere! Leistung' verweigert. 


TPA-Befehle sind aus dem Inhaltsverzeichnis der jeweiligen Disk- 
ette zu ersehen, sie sind gekennzeichnet durch die Buchstaben COM 
als "Anhängsel' an den Befehlsnamen. Sie unterscheiden sich im 
übrigen von 'normalen' Programmen nur durch die Tatsache, daß es 
sich dabei ausschließlich um Programme handelt, die in irgend- 
einer Art mit der Diskettenverwaltung zu tun haben. 


Doch nun ist es an der Zeit einmal einen Befehl auszuprobieren, 
wir geben dazu ein: 


Ardır 


A: dFm3 SYS : CR com ı Pif Com; SI0 Cem: ERASE  CüM 
A: TEST 29: CHARIO 250 : OTSKIO 259 : MBASIC COM : TEST EAS 
A: FURMT CM GENCFM DAT: CHARIO EL : BIOSKRNL REL : GEN AB 


Ganz offensichtlich handelt es sich hier um die Ausgabe des 
Inhaltsverzeichnisses der gerade eingelegten Diskette. 


Nicht alles was mit 'COM' endet sind TPA-Befehle, die meisten 
sind vielmehr sogenannte Programme, dazu jedoch später. 


Eine zusätzliche Möglichkeit haben wir bisher völlig unerwähnt 
gelassen, 


das Umschalten von Laufwerken: 


Es ist trivial, muß aber erwähnt werden. Unter CP/M hat jedes 
Laufwerk "seinen', wenn auch nicht gerade sehr phantasievollen 
Namen. 


Das Laufwerk auf das gebootet wurde, hat üblicherweise den Namen 
'A', weitere Laufwerksnamen sind 'B' ‚'C'" bis 'P'. Welche davon 
wirklich vorhanden sind, hängt vom Gerät ab. Dies sollte in der 
Gerätebeschreibung (des Computerherstellers) zu finden sein. 


Nicht unbedingt kann dies durch Abzählen der sichtbaren Laufwerke 
geschehen, es kann sehr wohl eine RAM-Disk im Gerät sein oder 
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eine vorhandene Harddisk ist in zwei oder mehrere logische Lauf- 
werke aufgeteilt. Dann müßte jeder dieser Einheiten ein eigener 
Laufwerksname zugeteilt werden. 


Zurück zum Laufwerkswechsel: 


Wird ein anderes Laufwerk gewünscht, wird einfach sein Name ge- 
folgt von einem Doppelpunkt eingegeben und der CCP reagiert 
sofort: 


A>bı 
B>_ 


Ist ein Laufwerk (physikalische) nicht vorhanden, wird dies ge- 
meldet mit: 


A>bı 
CP/M Error in B: invalid Drive 
BDOS Function = 14 


Leider 'spricht' CP/M (fast) nur Englisch. Gemeint ist hier ganz 
einfach, daß das Laufwerk 'C' ungültig, im Sinne von nicht vor- 
handen ist. Dies wurde mit der BDOS-Funktion 14 festgestellt. 
Fraglich in diesem Zusammenhang ist, was wohl eine BDOS-Funktion 
ist. Darauf wird sehr ausführlich in Teil III eingegangen, so sei 
hier also einfach einmal "hingenommen'. 


Soll in einem Befehl oder Programmaufruf ein anderes Laufwerk 
angesprochen werden, so kann dies auf zweierlei Art geschehen: 
entweder man spricht zuerst das Laufwerk wie oben gezeigt an oder 
spezifiziert in der Befehlszeile, welches Laufwerk gemeint ist: 


Bidır a! 


A: cpm3 SYS: ccp com : PIP com : SID com: ERASE Cum 
A: TEST 226 : CHARIO 286 : DISKIO Zeu ı MEASIC COM: TEST BAS 
A: FORMAT COM: BENCM DAT: CHAKIO Rel : BIOSERNL Rel : GEN Sir 


Ganz offensichtlich wird hier von Laufwerk 'B' aus das Inhalts- 
verzeichnis des Laufwerkes 'A' abgerufen. 


Ehe wir weitere Befehle vorstellen, wollen wir uns nun etwas 
intensiver mit der Befehlszeile beschäftigen, also dem Schreib- 
raum hinter dem Meldezeichen (dem sog. Prompter) 'A>'. 


Dies ist die einzige Kommunikationsstelle zwischen Benutzer und 
dem CCP, hier erwartet der CCP "seine! Befehle, jeweils abge- 
schlossen mit einem <CR>. 


Kenner von CP/M 2 haben sich sicherlich oft genug geärgert, wenn 
sich in einer langen Befehlszeile ein Tippfehler eingeschlichen 
hatte, ....alles nochmal - dies hat unter CP/M 3 (leider nur in 
der gebüıkten Ausführung) ein Ende, 


Digital Research hat CP/M 3 für die Befehlszeile einen Editier- 
modus beschert. Mit wenigen Wordstar-ähnlichen Kontrollsequenzen 
kann selbst ein bereits vom CCP als fehlerhaft zurückgewiesener 
Text editiert und neu verwendet werden. Die entsprechenden Kon- 
trollsequenzen sind in Tabelle 1 zusammengefaßt. 
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Ein Hinweis: 


Ein Kontrollzeichen z.B. CTRL-C wird durch gleichzeitiges Drücken 
der CTRL-Taste und der entsprechenden Zeichentaste erzeugt. Unbe- 
kannte oder nicht zum Zeileneditor gehörende Kontrollzeichen 
werden durch einen vorangestellten Aufwärtspfeil auf dem Bild- 
schirm wiedergegeben. 


+--------- + 
CTRL A bewegt den Cursor ein Zeichen nach links bis zum 
’?>’ ohne das entsprechende Zeichen zu löschen. 
CTRL B bewegt den Cursor an die Position direkt nach dem 


! 
' 
' 
’>’ ohne den Text zu verändern. Ist der Cursor ı 

bereits an dieser Stelle, wird er zum Textende ! 

bewegt. \ 

CTRL E erzwingt ein CR ohne dabei die Befehlszeile ı 
logisch abzuschliessen. Dies ist von Bedeutung, ! 

wenn man lange Befehlssequenzen eingeben muß, aber ! 

eine bessere übersicht auf dem Bildschirm be- ! 

halten möchte. ' 
ı 

l 

' 

! 

ı 

ı 

ı 

\ 

ı 

! 

ı 


CTRL F bewegt den Cursor ein Zeichen nach rechts, ohne 
das entsprechende Zeichen zu löschen. 
CTRL G löscht das Zeichen unter dem Cursor und rückt 


den Text rechts davon, nach links auf. Der Cursor 
bleibt an seiner momentanen Position. 

CTRL H oder BS (backspace) löscht ein Zeichen und bewegt 
den Cursor eine Position nach links. Die gleiche 
Funktion ist u.U. auch mit der DEL(ete)-Taste 
möglich. 

CTRL I oder TAB, bewegt den Cursor um eine TAB-Position 
nach rechts. TAB-Position ist jede 8. Spalte. \ 

ETRL I oder LF (linefeed) signalisiert das Befehlsende. Es! 
hat den gleichen Effekt wie CNTRL-M. Dieses Zeichen! 
kann an jeder beliebigen Cursorposition eingeben ! 
werden und veranlaßt dann, die Abarbeitung des 
konpletten Befehls in der Befehlszeile, d.h. auch 
der Text hinter diesem Zeichen wird abgearbeitet. 


CTRL K löscht die Restzeile ab der Cursorposition. 
CTRL M oder CR siehe CTRL-J. 
CTRL R schreibt den bisher editierte Text (der besseren 


ı 
ı 
ı 
1 
ı 
1 

übersicht halber) mit allen vorgenommenen Kor- ! 

rekturen noch einmal. ı 
CTRL U löscht den Zeileninhalt und rückt eine ! 

Zeile tiefer. ' 
CTRL W bringt die ’alte’ Befehlszeile zurück in Jen ı 

Zeilenpuffer zum Editieren. So können von CP/M ! 
reklamierte Fehleingaben einfach korrigiert werden. ! 
CTRL X löscht die Befehlszeile und setzt den Cursor ! 
direkt nach dem Prompter ’>’ ! 


Tabelle 1 Editiersequenzen des Zeileneditors 
Es müssen an dieser Stelle noch einige häufig benutzte Kontroll- 


zeichen angeführt werden, die der Bildschirmausgabe und der Druk- 
kersteuerung dienen. Sie sind in Tabelle 2 zusammengestellt. 


zur nachfolgenden Tabelle 2 noch eine Anmerkung für Umsteiger von 
CP/M 2. Unter CP/M 3 kann eine Textausgabe wie gewohnt mit CTRL S 
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angehalten werden, weiter geht es jedoch NUR mit CTRL Q. Ein 
Vorteil hat die Sache jedoch: nach CTRL S kann mit CTRL P der 
Drucker zu- oder abgeschaltet werden. 


de 1 1 I 


CTRL € Zurücksetzen des Betriebssystems oder Abbruch einer ' 
Ausgabe. Wird nur an erster Stelle hinter dem ’>’ |! 
akzeptiert. ! 

CTRL P schaltet den Drucker ein (falls vorhanden) und gibt ! 
bis zu einem erneuten CTRL P alle Bildschirmausgaben! 
auch auf den Drucker aus. Ist kein Drucker ange- \ 
schlossen kann dies ein 'Hängenbleiben’ verursachen \ 

CTRL $ eine Textausgabe auf dem Bildschirm kann mit diesen ' 
Kontrollzeichen angehalten werden. ! 

CTRL Q mit diesem Zeichen läuft die Bildschirmausgabe ! 
wieder weiter. ! 


Tabelle 2 Steuerzeichen für Bildschirm- und Druckerausgabe 


Es ist nun an der Zeit einige immer wiederkehrende Begriffe 
vorzustellen und zu erläutern. Dazu noch einmal einen Auszug aus 
einem Inhaltsverzeichnis: 


Ardır 


Ace WS: CP com: FIF com SID com; ERASE COM 
A: TEST 256 : CHARIO 286 : DISKIO ZUR ı MBASIC Gin ı TEST eAS 
A: FORMAT COM: GENCPM DAT: CHARIO ReL : EIOSERNL REL I GEN Sub 


Am Anfang jeder Zeile steht der Name des Laufwerkes, in welchem 
das Inhaltverzeichnis der dort eingelegten Diskette gelesen wur- 
de. Dahinter kommt ein Name, meist gefolgt von einigen Leer- 
zeichen, und dann noch mal ein Name. Nach einem Doppelpunkt folgt 
die gleiche Sequenz mit anderen Namen noch 4 mal, nur am Ende 
fehlt der Doppelpunkt. 


Betrachten wir die Namen nun einmal genauer. Sie bestehen aus 
zwei Teilen: 


l. dem eigentlichen Dateinamen 


Er darf bis zu 8 Zeichen enthalten, die eine sinnvolle Be- 
zeichnung der entsprechenden Datei ergibt. 


2. den Index (oder engl: extend) 


Er kann bis bis zu drei Zeichen enthalten und dient dazu, 
einen Dateinamen nach seiner Art zu spezifizieren. Der 
Index wird vom Dateinamen durch einen Punkt <.> getrennt. 


Der Dateiname (wir wollen darunter ab sofort Namen und Index 
verstehen), darf nicht durch ein Leerzeichen getrennt sein. Alle 
darstellbaren Zeichen, außer den in Tabelle 3 zusammengestellten 
Sonderzzichen, die für bestimmte "Regieanweisungen' benötigt 
werden, sind zugelassen. 


Der Index kann u.U. auch entfallen, falls er nicht aus zwingenden 


Gründen (wie bei COM- oder SUB-Dateien) vorgeschrieben ist. Der 
Dateiname muß jedoch aus mindestens einem Zeichen bestehen. 
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ge, E38 E]I Zeichen die der Dateispezifikation dienen! 

TAB, SPACE (=Leerzeichen) Beides beendet einen ! 
Dateinamen. 

CR (Return) Beendet eine Befehlzeile 


Trennt Datei-Namen von Datei-Index 


ı 
' 
Beendet eine Laufwerksangabe ' 
I 
Trennt Datei-Namen von Passwort ! 


x? gelten als JOKER (ersetzen jedes Zeichen)! 
<> ll ı \+- Trennzeichen bei der Angabe von Öptionen |! 
E] Trennzeichen fuer globale und lokale ' 
Optionen 
0» Trennzeichen fuer Mehrfachoptionen 
I Trennzeichen fuer Optionen in der (CCP- 


Befehlszeile 

\ Trennzeichen fuer Mehrfachbefehle in der 
Befehlszeile 

’ Trennzeichen am Beginn einer Befehls- 
Zeile fuer einen nachfolgenden Kommentar 


Tabelle 3 Reservierte Zeichen 
die nicht in Dateinamen verwendet werden dürfen. 


Der CCP unterscheidet bei der Befehlseingabe nicht zwischen 
Groß- und Kleinbuchstaben, vielmehr werden alle Buchstaben (in- 
tern) in Großbuchstaben umgewandelt. 


Als Namen für den Index sind einige Begriffe festgelegt, andere 
haben sich eingebürgert. Die meisten bleiben jedoch der Fantasie 
des Benutzers überlassen. Eine Zusammenfassung der unterschied- 


eher enı jedoch häufig benutzten Indizes ist in Tabelle 4 zu 
inden,. 


+---- --- 2 + 
ı COM ein MUSS für alle ablauffähigen Programme \ 
ı ASM Index einer Assembler (Quellcode-) Datei ' 
! MAC Index einer Assemblerdatei für den MAC-Assembler ! 
L TAT Index für eine TeXT-Datei ' 
' DOC für DOCumentation ! 
! SUB ein MUSS für SUBmit-Dateien ! 
! REL für linkbare Programmsegmente ' 
! HEX für Dateien im (INTEL-) HEX-Format ' 
\ BAK von BAckup abgeleitet, einer Sicherungsdatei wie ! 
! sie von Editoren erstellt wird ! 
! BAS Kennzeichnung einer BASIC-Datei ! 
ı FOR Kennzeichnung einer FÖRTAN-Datei ! 
! PAS Kennzeichnung einer PASCAL-Datei ' 
! HLP Overlay-Datei mit HILFE-Menüs ! 
! DAT Eine Datei, die DATen (beliebiger Art) enthält ! 
! 230 Kennzeichnung einer Assemblerdatei in Z88-Mnemonics! 
mn m nn + 


Tabelle 4 Gebräuchliche Abkürzungen des Dateinamen-Index 
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Es bleibt an dieser Stelle nur noch die Erläuterung des Begriffes 
DATEI. Prinzipiell ist darunter Alles zu verstehen, was unter 
einem Dateinamen auf einer Diskette abgepeichert werden kann. Es 
ist also ein Sammelbegriff für Daten ganz allgemein, 


Für einige bestimmte Dateiarten sind jedoch feste Begriffe be- 
kannt: 


PROGRAMM ist eine Datei, die nach Aufruf eine festgelegte 
Arbeit übernimmt. Beispiele sind Editoren, Hochspra- 
chen (BASIC, PASCAL usw), aber auch Assembler und De- 
bugger, um nur einige zu nennen. Alle Programme sind 
durch den Index COM kenntlich gemacht. 


Es gibt darüberhinaus eine bestimmte andere Programm- 
art, das sogenannte 


SUBMIT- Programm, gekennzeichnet durch den Index SUB. Mit 
seiner Hilfe ist es möglich verschieden CCP-Befehle in 
einer Datei zusammenzufassen und diese Befehlsfolge 
wie einen Befehl abzurufen. Als typisches Beispiel sei 
die folgende Submitdatei MAKESYS zur Generierung eines 
CP/M 3 Systemes vorgestellt: 


EU SCE,EIOSKRKL ‚BOOT MOVE DISK.IO, CHARIO 
LINK BNK&EIOSSTEI=SCE, BIGSKRNL BOOT, MOVE, DISK 10, CHARIO 
GENEPM AUTO 


Anmerkung: 


280.COM ist ein Assembler, der hier aufgerufen wird, um die 
Dateien SCB.280. BIOSKRNL.280, BOOT.280, MOVE.Z80 sowie DISK- 
10.280 und CHARIO.280 zu assemblieren und als "REL'-Dateien abzu- 
legen. Alle genannten Dateien werden danach durch das Programm 
LINK.COM in eine Datei BNKBIOS3.SPR ge'linkt'. Danach wird mit 
dem Programm GENCPM (AUTOmatisch) ein neues CPM3.SYS generiert. 
Alle 3 Zeilen könnten mit dem gleichen Ergebnis auch einzeln 
(hintereinander) in der Befehlszeile eingegeben werden. Da diese 
"Operation" jedoch recht häufig vorkommt, wurden alle Befehle in 
einer Datei zusammen gefaßt - und können so mit einem Befehl, dem 
Dateinamen, aufgerufen werden. 


Beide Programmarten werden durch einfache Namenseingabe ohne 
Angabe des Index aufgerufen. 


Ein Programm kann u.U. auch nicht direkt ablauffähig sein, wie 
dies bei BASIC-Programmen der Fall ist, die erst in Zusammenar- 
beit mit einem BASIC-Interpreter funktionsfähig sind. 


In diesem Falle wird erst die Hochsprache aufgerufen und dann 
erst aus dieser heraus das Programm. Häufig kann jedoch bereits 
in der Befehlszeile Hochsprachenname und Programmname eingegeben 
werden. 

A>mbasic test 


In diesem Beispiel wird das Programm MBASIC.COM aufgerufen, das 
wiederum das Programm TEST.BAS aufruft und ausführt. 
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Andere Dateien können nun beispielweise nur Text enthalten, man 
spricht dann von Textdateien (allgemein). Ist dieser Text z.B. 
ein Assembler-Programm, handelt es sich logischerweise um eine 
Assemblerdatei; bei einem BASIC-Programm um eine BASIC-Datei. 


Es ist auf jeden Fall klar zu unterscheiden, ob es sich bei einer 
Datei um Daten im ASCII-Format handelt, also um direkt lesbare 
Zeichen (was auch für eine HEX-Datei gelten würde) oder um Daten 
in binärer Darstellung, also in einer Form wie sie direkt von der 
CPU interpretierbar sind. Letztere Form gilt im allgemeinen für 
alle Programme, a 

Diesen Unterschied zu (er)kennen ist wichtig zur Anwendung des 
Befehles TYPE und des Hilfsprogrammes DUMP. Mit TYPE werden Daten 
in ASCII ausgegeben - also Daten, die wie "normaler! Text zu 
lesen sind. Mit DUMP dagegen werden Daten ausgegeben, die (von 
diesem Programm) erst in lesbare Form umgewandelt und dann auf 
den Bildschirm ausgegeben werden. 


Dies sei an 2 Beispielen deutlich gemacht. (Alle Beispiele sind 
in der Ausgabe gekürzt, da sie nicht zur Auffüllung des Buches 
sondern zur Erläuterung benutzt werden sollen.) 


Aramp ws con 


(P/M 3 DuMP = Version 3.5 








LEE CE TI EEE =. 
13T... COPYRIG 
EHMIEEIAHTLDIMDMUMEIER HT (CO) 181 Mic 
Ma TIEF SO 72 EF 20 AI BE 7465 72 BE AI TARI HF ropro Internatio 
By: GE RI RC MAIER 72 7A EF 7261 7469 5F KE nal Corporation 

AO EI I TA KF SO 72 BF 20 57 6F Nıcropro Wo 
WE TIER SE TAEI 7220 MT2ES EC E56 7265 Foster release 
WTA: 33 2E30 30 20 20 7365 7263 51 50 20 23 0 57 3.00 serial # W 


Artype help.hip 
IN commanıs 
(P/M 3 Command Format: 
APCOHMAND (command tail) <cr> 


ACP/M 2 command line is compesed of a command, an optıonal 
ccrmand tail, and a carriage return. The command is the name or 
filenare of a program t9 be exscuted. The optional camaand taıl 
can consist of a drive specification, one or more file 
specifications, and some options ar parameters. 


Die Unterschiede sind recht deutlich zu erkennen. Bei DUMP er- 
folgt die Ausgabe immer in HEX auf der linken Bildschirmhälfte, 
in ASCII auf der rechten Bildschirmhälfte,. Dabei ist gut zu 
erkennen, daß beim 'DUMP' zum Beginn ein Teil "unleserlich' 
bleibt. Hier handelt es sich um die Darstellung in HEX-(adezimal) 
vom Maschinencode, dieser (nicht ausdruckbare) Code wird im 
ASCII-Teil durch einen Punkt <.> dargestellt. 


Würde versucht, den Inhalt dieses Beispieles mit TYPE auf dem 
Bildschirm auszugeben, würden, je nach Art der Bildschirmausgabe, 
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die merkwürdigsten Dinge auf dem Bildschirm passieren. Es wäre 
nicht verwunderlich, wenn sich das ganze System "aufhängen' 
würde. 


Ganz links die Zahlen vor dem Doppelpunkt sind relative Adress- 
angaben. 


Bei den Programmen unterscheidet CP/M 3 selbst zwischen den 
"normalen' Programmen und den sogenannten SYS(tem)-Programmen. 
Nirgends in den Unterlagen wird aber etwas darüber ausgesagt, was 
ein SYS-Programm ist und was nicht, es bleibt dies völlig dem 
Benutzer überlassen, 


w 
Die folgende Definition ist jedoch weit verbreitet und auch sinn- 
voll: 


Alle Hilfsprogramme auf einer Diskette, die das System an 
sprechen, (also die TPA-Befehle) und alle COM-Programme 
(z.B. Editoren Debugger und Assembler aber auch Hochspra- 
chen) werden zu SYS-Dateien (mit dem TPA-Befehl SET.COM) 
erklärt. Sie können mit diesem Programm auch noch schreib- 
geschützt werden und 'verschwinden' damit aus dem "norma- 
len' Inhaltsverzeichnis. 


Ihr Vorhandensein kann mit dem CCP-Befehl DIRS überprüft 
werden. 


Der Vorteil dieser Handhabung ist es, daß man im Inhaltsver- 
zeichnis nur noch das Wesentliche hat. Es bleibt somit über- 
sichtlich und auf den der Diskette zugewiesenen Arbeitsbereich 
beschränkt. 


Werden Systemdateien eingeführt, meldet DIR und DIRS das vVor- 
handensein von Dateien aus dem "anderen! Bereich mit der mMel- 
dung: 


SYSTEM-FILES(S) EXISTS 


Dateien, die als SYStem-files deklariert wurden, haben darüber- 
hinaus noch einen besonderen Vorteil: sie können aus allen USER- 
Ebenen aufgerufen werden, 


Zum weiteren Verständnis dieses Begiffes wenden wir uns jetzt dem 
Befehl USER zu: 


Mit dem USER-Befehl kann der Speicherplatz einer Diskette oder 
Harddisk in bis zu 16 Benutzerebenen aufgeteilt werden. Darunter 
ist im Prinzip eine Aufteilung des Speicherraumes einer Diskette 
in Segmente mit einem "eigenem' Inhaltsverzeichnis zu verstehen. 


Diese Segmentierung einer Diskette ist eigentlich nur von Vor- 
teil, wenn die Diskettenkapazität sehr groß ist oder wenn es sich 
um ein Mehr-Benutzersystem handelt - und das ist ein CP/M Gerät 
nun ja weist nicht. 


Die Diskettenkapazität selbst verändert sich bei dieser Manipu- 
lation nicht. Auf "normalen' Disketten bringt die Aufteilung in 
USER-Ebenen nur dann Vorteile, wenn z.B. zu Archiv-Zwecken Pro- 
gramme abgelegt werden, die u.U. gleiche Namen tragen. In diesem 
Falle würde sonst jedes Kopierprogramm die bereits vorhandene 
Datei gleichen Namens einfach überschreiben. Wird jedoch in 
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unterschiedliche USER-Ebenen kopiert, so weiß die eine Ebene 
nichts von der anderen Ebene, 


Prinzipiell kann aus jeder USER-Ebene auf alle SYS-Programme 
zugegriffen werden, aber nicht (so ohne weiteres wenigstens) auf 
Programmteile, die in anderen USER-Ebenen liegen. D.h. allen 
Segmentbenutzern (den USERn) stehen alle Befehle und Programme 
mit gesetztem SYS-Attribut zur Verfügung, aber alle Dateien in 
‘"seiner' Ebene nur dem jeweiligen USER. In diesem Zusammenhang 
muß der jeweilige USER natürlich nicht notgedrungen eine andere 
Person sein. 


Ein sinnvolles Beispiel der Anwendung von USER-Ebenen ist der 
Fall, daß in USER-Ebene 1 alle notwendigen Dateien zur Generier- 
ung eines CP/M3 Systemes mit einer besonderen Hardware-Anpassung 
liegt, während in USER-Ebene 2 alle Dateien für eine völlig 
andere Anpassung liegen, Der Benutzer kann so allen Dateien ihren 
"angestammten' Namen belassen und muß trotzdem kein verhängnis- 
volles Vertauschen befürchten. 


Bei Harddisks mit großem Speicherbereich wird die Benutzung ver- 
schiedener USER-Ebenen erst so richtig sinnvoll. Dort kann z.B. 
in USER-Ebene 1 alles sein, was mit Textverarbeitung zu tun hat; 
in Ebene 2 alles für die Buchhaltung, in Ebene 3 alles was mit 
BASIC zu tun hat. So bleibt das Inhaltsverzeichnis immer über- 
sichtlich und der Aufgabenbereich auf bestimmte Benutzerebenen 
beschränkt. 


Nun noch zur Umschaltung in USER-Ebenen, dies ist genauso einfach 
wie die Laufwerksumschaltung: 


A>2: 
2A>_ 


Der CCP meldet sich nun zuerst mit der USER-Ebene (0..15) und 
dann mit dem Laufwerksnamen. Beim Ändern des Laufwerkes, wird die 
USER-Ebene "mitgenommen': 


2A>b: 
2B>_ 


Es kann auch Laufwerk und USER-Ebene gleichzeitig gewechselt 
werden: 


2B>8A 
BA<_ 


Die USER-Ebene 0 wird nicht extra angezeigt. Alle eingebauten 
CCP-Befehle arbeiten in jeder USER-Ebene, aber alle sonstigen 
Programme und TPA-Befehle arbeiten nur wenn sie als SYS-Dateien 
deklariert wurden oder sich mit auf der USER-Ebene befinden. Ein 
Hilfsprogramm mit der Bezeichnung PIP.COM ermöglicht den Transfer 
zwischen den USER-Ebenen. Ein direkter zugriff zwischen den USER- 
Ebenen ist nicht möglich. 


Mit dem Befehl REN kann eine Datei im Inhaltsverzeichnis umbe- 
an aaa (RENamed). Der Syntax hierzu ist ebenfalls recht 
einfac 


A>ren test,.asm=test.z80 
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In diesem Beispiel wird die (vorhandene) Datei TEST.280 in die 
Datei TEST.ASM umbenannt, von der Syntax her also: 


Neuer Name=Alter Name 

Nun noch ein "gefährlicher! Befehl: ERA dieser Befehl löscht 

(ERAsed) eine Datei aus dem Inhaltsverzeichnis - ohne ganz 

spezielle Hilfsmittel unwiderruflich Ill 

Ayera test.asm 

Es verbleibt für dieses einführende Kapitel nur noch eine Klei- 

nigkeit, nämlich die Möglichkeit der Anwendung von JOKERN bei 

der Eingabe von Dateinamen: 

l. Jeder Buchstabe kann durch ein Fragezeichen ersetzt werden. 
In diesem Falle wird jedes beliebige Zeichen an seiner 
Stelle akzeptiert. 

Beispiele: 
dir as??.??? zeigt z.B. Dateien wie 
ASM.COM, ASTI.TXT, AS.COM, AS.HEX, AS.ASM usw 

2. Ein Namens-Rest kann durch einen Stern '*' ersetzt werden, 
in diesem Falle wird (intern) der gesamte Namensrest mit 
?2??? aufgefüllt. 

Beispiele: 

dir *.COM zeigt alle Dateien mit dem Index COM 

dir At,* zeigt alle Dateien die mit A beginnen 

dir %,%* würde wiederum alle Dateien zeigen 
hätte also keinen besonderen Effekt 

Jocker können bei allen CCP-Befehlen und bei den meisten Hilfs- 

programmen eingegeben werden. Bei einigen Befehlen wird dazu der 

entsprechende TPA-Befehl benötigt. Ist er nicht vorhanden wird 
dies vom CCP gemeldet: 

A>ren t*.asm=t*.zB0 


RENAME COM required 


Noch ein letzter Hinweis zur Befehlszeile: 
Dateinamen werden von fast allen Befehlen und Programmen nur mit 


Name UND Index akzeptiert. Hiervon ausgenommen ist nur der Pro- 
grammaufruf von COM und SUB Dateien. 
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Kapitel 2 Die Befehlserweiterungen des CCP 


In diesem Kapitel beschäftigen wir uns mit den unter CP/M 3 zur 
Verfügung stehenden Erweiterungen des CCP-Befehlssatzes. Teil- 
weise ist dazu die Voraussetzung mit anderen Hilfsprogrammen zu 
schaffen. Dies wird in jedem Falle erwähnt. Der Umgang mit den 
entsprechenden Programmen wird jedoch erst im übernächsten Ka- 
Pitel behandelt. Es sei dem Benutzer jedoch überlassen für eigene 
Versuche die entsprechende Beschreibung bereits vorab zu lesen. 


Eines der wichtigsten Dinge bei einem Disketten-Betriebs- 
system ist es, daß unbedingt vor jedem Arbeiten mit unbe- 
kannten Dateien Sicherungskopien gemacht werden. Kein Soft- 
ware-Haus und kein Distributor wird durch Unachtsamkeit 
gelöschte oder sonst wie unbrauchbar gewordene Diskette 
zumindest ohne Zusatzkosten ersetzen. 


Dem Einsteiger in CP/M soll daher an dieser Stelle dringend 
geraten sein, sich die vom Lieferanten seines Gerätes mitge- 
lieferten Unterlagen noch einmal genau durchzulesen. Er sollte in 
der Lage sein, Disketten zu formatieren, die Systemspu-en und 
alle Programme auf eine Arbeitsdiskette zu kopieren. 


Die dazugehörenden Vorgänge werden zwar in diesem Buch prinzi- 
piell besprochen, dıe entsprechenden Programme (FORMAT, COPYSYS 
oder wie immer der Distributor sie genannt hat) sind jedoch nicht 
einheitlich aufgebaut. Sie werden in den meisten Fällen vom 
Gerätehersteller, nicht von Digital Research, geschrieben und 
entziehen sich daher einer genauen Beschreibung (falls diese 
nicht mitgeliefert wurde). Die meisten Programme dieser Art sind 
jedoch Menü-geführt und "narrensicher'. Diese Programme sind 
immer hardware-abhängig, also auch nur bedingt unter verschie- 
denartigen Systemen austauschbar. 


Die nachfolgende Beschreibung des erweiterten Befehlssatzes er- 
folgt für jeden Befehl getrennt nach einer einheitlichen Syntax, 
Dieses Prinzip wird auch für die Beschreibung der Hilfsprogramme 
und "Werkzeuge! beibehalten, um dem Benutzer einen schnellst- 
möglichen Überblick zu schaffen. Alle Beschreibungen beginnen am 
Anfang einer neuen Seite. 


Eine wichtige Option sei an dieser Stelle ohne nähere Erläuterung 
bereits erwähnt. Viele Befehle und Hilfprogramme veranlassen 
Bildschirm-Ausgaben. Diese liefen unter CP/M 2 über den oberen 
Bildschirmrand hinaus falls sie nicht mit CTRL-S rechtzeitig 
angehalten wurden. 


Unter CP/M 3 wird nur eine volle Seite ausgegeben, dann hält die 
Ausgabe an mit der Meldung: 


Press RETURN to Continue 

d.h. die nächste Seite wird nach drücken der RETURN (CR) Taste 
ausgegeben - meist tut es aber JEDE Taste außer CTRL-C, damit 
würde die Ausgabe abgebrochen. (Siehe hierzu auch Tabelle 2) 

Bei manchen Gelegenheiten kann diese Option jedoch auch störend 
sein, wenn z.B. ein Text mit TYPE und CNTRL-P auf den Drucker 
ausgegeben werden soll. Hier bietet sich folgende Möglichkeit: 


Artype test.asalnopage] 
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Die Option NOPAGE (in eckiger Klammer)verhindert das Abfragen am 
Bildschirmende. Diese Option kann mit dem Hilfsprogramm SETDEF 
auch fest vorgegeben werden und explizit für bestimmte Ausgaben 
zurückgenommen werden, 


Atype test.asmlpage] 


Noch etwas hat Digital Research seinem neuen CP/M (3) mitgegeben: 
Es können üblicherweise mehrere Befehle in einer Zeile gegeben 
werden, dies ist einfach durch Trennen dieser Befehle mit einem 
Ausrufezeichen möglich. 

A>diridirs 

Es muß hier aber vermerkt werden: 

bei manchen Programmen die CP/M nur als Vehikel für eigene Auf- 
gaben verwenden ist dies nicht möglich, leider auch bei einem 
sehr bekannten, hervorragenden Assembler ... 

Sogar Digital Research hat sich da selbst ein Bein gestellt, 
versuchen Sie es einmal mit der Sequenz: 

A>dirICNTRL-C 

also: Aufruf des Inhaltsverzeichnis und danach CTRL-C zum Ab- 


bruch. 


Sie sollten dies jedoch wirklich nur dann versuchen, wenn sie 
wissen, wo bei Ihrem Gerät der RESET-Knopf ist .... 


Anmerkung: in einem von DIGITAL RESEARCH genannten Patch ist 


dieser Fehler in der Zwischenzeit behoben - ist IHRE Version noch 
nicht geändert, fragen Sie Ihren Distributor I 
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Kapitel 3 Die CCP-Befehle im Detail 


LEE 22 2 2 2 2 2 2 2 2 2 ee 2 er 
* DIR(S) * Der DIR(S)-Befehl 
La 2.2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 27 


Syntax: 


DIR id!) Cfilename) (lüptionen]) 
DIFSCYS) (di) Üfilename) (Löptionen)) 


Beschreibung: 


Der DIR- oder DIRS-Befehl zeigt das Inhaltsverzeichnis einer 
Diskette mit den Diskettennamen, Attributen und sonstigen Infor- 
mationen wie Dateigröße, Anzahl der logischen und physikalischen 
Blöcke, Anzahl der Dateien auf der Diskette und der von ihnen 
benutze Speicherraum usw. 


In seiner einfachsten Anwendung ist DIR ein Befehlswort des CCP. 
Außer einem allgemeinen Inhaltsverzeichnis ist er in dieser Form 
nur in der Lage, Auszüge aus dem Inhaltsverzeichnis mit Hilfe von 
JOKERN auszugeben: 


A>dir b:a*,* 
A>dirs ?80.COM 


Für den Benutzer sind u.U. aber weitere Informationen von Inter- 
esse. Der CCP-Befehl ruft bei weiterer Anforderung an sein 'Lei- 
stungsvermögen' die Datei DIR.COM auf. Findet er sie nicht, 


meldet er: 

DIR COM required 

Mit dem Befehl DIR kann auf alle Dateien, die nicht als SYS- 
Dateien deklariert wurden, zugegriffen werden; mit DIRS oder 
DIRSYS entsprechend auf alle SYS-Dateien, ansonst unterscheiden 
sie sich in der Anwendung nicht. 

Werden gesuchte Dateien nicht gefunden, wird dies gemeldet 

NO File 

Sind Dateien in der SYS- (bzw umgekehrt in der DIR-) Ebene vor- 
handen, die den Spezifikationen des gewünschten Dateinamen ent- 
sprechen, wird dies wie folgt gemeldet: 


SYSTEM FILE(S) EXIST 
NON-SYSTEM FILE(S) EXIST 


In Tabelle 5 sind alle Optionen aufgeführt, die mit dem DIR(S)- 
Befehl möglich sind. 


Auf der folgenden Seite jedoch zuerst noch einige Beispiele: 
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Adır b:lfull) 


Scanning Directory... 
Sartıng Dırectory... 


Directory For Drive B! User 6 








Nane Ertes Recs Attrıbutes Frot Update Create 
EICH Sk 45 Dır Re None 12/07/85 16:39 12/A7/ES 1ER 
BUCH EBK 5% 495 Dir RW None 12/67/85 16:39 
HELP DT Ei 477 Dır RW None 1e/e37E5 Ne: 1a 
Ins] 2 1 Dir Aw None 11/23/85 11:33 
INSERT 4 22 Dır RW None 12/87/85 15:22 12/87/85 15:11 
INSERT  EAK 4k 17 Dır RW None 12/87/85 15:22 
TABI TAT & 17 Dır RW Kane 1/ar/ES 845 
TABELLE TAT dr 54 Dir RW None 12/02/85 18:55 
WS (mM Nee 124 Dar RW har 16/09/85 18:15 
WemSGS OVR Zi 192 Dir Au None 18/09/85 16:15 
KSOMYI OVR 34 266 Dir RW Nana 1e/89785 1eile 


Total Bytes 
Total Ik Blocks 


26x Total Record = 1%51 Files Found= 11 
252  Useg/Max Dir Entries For Drive Ei 27 Ze 


Araır b:lsize) 


Scannıng Directory... 
Sorting Directory... 


Directory For Drive Ei ser € 


B: BICH 5a: Buch [1 ey Zr SE 2 DAT 50 
Ei in: A INSERT MIET EA 4 
B: TAB DT Ar: TABELLE DT 105 {0m 1er 
Ei WSMSE  OVR Zen WEOVLYT OVR ar: 


Total Bytes = 2&6k Total Records = 191 Files Fond= 1 
Total Ik Blocks = 253 Usad/Max Dir Entries For Drive BE 32/ 2£ 


Das erste Beispiel zeigt ein volles (engl: full) Inhaltsver- 
zeichnis. 


Dazu wird der TPA-Befehl DIR.COM aufgerufen. Unter 'voll' ist in 
diesem Falle zu verstehen, daß jede Datei mit Angaben zu 


l. Dateiname und Index (name) 

2. Dateigröße in Kilobytes (Bytes) 

3, Dateigröße in (log.) Sektoren (recs) 

4. Attributen (DIR/SYS RW/RD usw) (Attributes) 
5. Status des Paßwortschutzes (Prot) 

6. Zeitpunkt der Überschreibung (update) 

7. Zeitpunkt der Erstellung (create) 


versehen wird. Darüberhinaus werden noch folgende Angaben 


gemacht, die den "Belegungs'-Zustand der ganzen Diskette wieder- 
spiegeln: 
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Im 


Belegter Speicherplatz (ges.) in Kilobytes (total Bytes) 


dto in (log) Sektoren (total records) 


Anzahl der Dateien im Inhaltsverzeichnis (Files found) 


Belegung in 1k Blöcken (total 1k Blocks) 
Belegte/Maximale Einträge (Used/max Dir Entries) 


weiten Beispiel werden mehr oder weniger die 


Angaben gemacht bis auf die Punkte 3..7. 


Van Cm tm um m mn tm mm ms tn em tn mn tn en a tn nn en a m un dm mn mn m a m m en nn m nr nn m rn a en Kam 
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DI 
OR 


DR 
EX 


FF 


FÜ 


LE 


NÖ: 


NO 


RO 


US 


US 


Us 


gleichen 


in Zeigt die (Benutzerdefinierten) Attribute Fl, 


F2,F3 und FA. 


TE Zeigt alle Dateien, die mit Datums- und Zeit- 
marken versehen sind. Sind diese Marken nicht 


aktiv, wird die Fehlermeldung: 


“Date and Time Stamping Inactive> ausgegeben. 


R Zeigt nur Dateien mit dem DIR-Attribut. 


IVE=ALL Zeigt das Inhaltsverzeichnis aller aktivierten 


Laufwerke. 


IVE=(A,B,..) Zeigt das Inhaltsverzeichnis der angegebenen 


Laufwerke. 


CLUDE Zeigt alle Dateien des Inhaltsverzeichnisses, 
die nicht der angegebenen Namensspezifikation 


entsprechen. 


gıbt (falls der Drucker mit CNTRL-P zuge- 
schaltet ist) ein FÖRM-FEED (Seitenvorschub) 
aus, bevor das Inhaltsverzeichnis ausgegeben 
wird. Ist die Option LENGTH mit angegeben, 
wird nach n Zeilen das FÖRM-FEED wiederholt. 
KL. Das Inhaltsverzeichnis wird vollständig aus- 
gegeben, d.h. es wird neben den Dateinamen die! 
Dateigröße, der benutzte und der Rest- 
speicherplatz, die Anzahl der benutzten Ein- 
träge und evtl. vorhandene Datums- und Zeit- 


marken ausgegeben. 


NGTH=n Gibt die Anzahl der Zeilen, die vor Ausgabe 
einer neuen Kopfüberschrift ausgegeben wer- 


den an. 


'n’ kann im Bereich 5...65536 Zeilen sein 
PAGE Das Inhaltsverzeichnis wird ohne anzuhalten 


ausgegeben. 


SORT Das Inhaltsverzeichnis wird nicht alphabetisch! 


sortiert. 


Es werden nur Dateien mit gesetzem READ-ÜUNLY 


Attribut ausgegeben. 


Es werden nur Dateien mit gesetztem READ-WRITE! 


Attribut ausgegeben. 


ZE Es werden alle spezifizierten Dateien mit 
der Dateigröße (in Kilobytes) ausgegeben. 
5 Es werden alle Dateien mit gesetztem SYS- 
Attribut ausgegeben. (geht mit DIRS einfacher)! 
ERSALL Es werden alle Dateien, getrennt nach USER- 


Ebenen ausgegeben. 


ER=n Es werden alle Dateien in USER-Ebene n aus- 
gegeben. (Innerhalb einer USER-Ebene genügt 
DIR alleine falls DIR.COM als SYS-Datei 


deklariert wurde. 
ER=(6,1...) 
ebenen ausgegeben. 


Es werden alle Dateien in den genannten USER- 


Tabelle 5 Optionen zum DIR(S) Befehl 





Krkkkhahkhhhahn 


* ERA(SE) * Der ERASE-Befehl 
wre a a 


Syntax: 
ERALSE) (filenare){[Cionfire)) 
Beschreibung: 


Mit dem ERA-Befehl kann eine Datei aus dem Inhaltsverzeichnis 
gelöscht werden. Werden JOKER verwendet, wird automatisch das 
Hilfsprogramm ERASE.COM aufgerufen. Ist dieses nicht vorhanden, 
wird sein Fehlen gemeldet. 


Werden JOKER benutzt, wird nachgefragt, ob deı durch JOKER de- 
finierte Dateityp wirklich gelöscht werden soll. 


Bitte bedenken Sie, daß ein 'Wiedererwecken' einer einmal ge- 
löschten Datei nur mit ganz speziellen Hilfsmittel, (die nicht 
zum Lieferumfang von CP/M 3 gehören) möglich ist. 


Schreibgeschützte Dateien und Dateien, die mit einem PASS-Wort 
versehen sind, können nur gelöscht werden, wenn mit SET.COM der 
Schreibschutz aufgehoben wird, bzw. wenn das PASS-Wort bekannt 
ist. 


Durch Anhängen einer eckigen Klammer gefolgt von einem 'C' oder 
ausgeschrieben CONFIRM, wird jeder der Spezifikation entsprechen- 
de Dateiname auf dem Bildschirm ausgegeben, gefolgt von der 
Frage, ob die Datei gelöscht werden solle oder nicht. Die Frage 
ist mit Y (für JA) und N (für NEIN) zu beantworten. Aussteigen 
aus der Abfragekette ist mit der Sequenz CNTRL-S,CTRL-C möglich. 


Wird eine Datei nicht gefunden, so wird dies gemeldet mit dem 
lapidaren Text: 


ERASE COM required 


Nachfolgend noch ein Beispiel der 'serienlöschung' mit Nachfrage: 


ERA %.4[c) 

B: HLP  .DAT (Y/W?n 
RB: WSOVLYı .OVk (Y/ND? n 
B:EcH . WM? 
B: WMSES „OR (Y/N? n 
B: WS „Com (YIND? n 
B: INSERT . IN? n 
B: Tl DT CYYN?n 
B: TABELLE .EAK (Y/N? y 
Bi INSERT  .BAK OY/ND? y 
B: BUCH .EAK (WIN? y 
Bin? . IND? y 
B: TABELLE „TAT (Y/Nd® n 


co 
2 


25 


DE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 22 


* REN(AME) ® Der RENAME-Befehl 
WER 


Syntax: 
REN{AME) neuernanesalternane 
Beschreibung: 


Mit dem CCP-Befehl REN kann eine Datei des Inhaltsverzeichnisses 
umbenannt werden. 


Wird die gewünschte Datei nicht gefunden oder ist bereits unter 
dem gewünschten Namen eine Datei im Inhaltsverzeichnis abgelegt, 
folgt eine entsprechende Fehlermeldung: 


A>rename insl.txt=ins2.txt 
Na Fıla 


renane ıns2.txtzinsl txt 
FRGR: kat rananed INS? TAT fıle already exists, delete (Y/N) 


Ist eine Datei die umbenannt werden soll. nicht vorhanden, so 
folgt das lapidare No File = Datei nicht vorhanden. 


Wird ein bereits vorhandener Dateiname gewählt, so wird dies 
angezeigt und angefragt, ob die alte Datei gleichen Namens 
gelöscht werden soll (Y=JA, N=Nein). Wird die Frage verneint, 
wird keine Umbenennung vorgenommen. Im gezeigten Beispiel wurde 
die Datei INS2.TXT als bereits vorhanden gemeldet. 


werden JOKER im Dateinamen angegeben, wird vom CCP die Hilfsdatei 
RENAME.COM aufgerufen. 


RENAME.COM kann auch direkt, ohne weitere Angaben (jedoch dann 
mit vollem Namen,) aufgerufen werden. Das Programm fragt dann 
selbst nach weiteren Angaben: 


A:rename 

Enter New Name! text.new 
Enter Old Name; textl.new 
ara ro such file to rename 


Es wird zuerst nach dem neuen Dateinamen gefragt (New Name), dann 
nach dem alten (bisherigen) Dateinamen (Old Name). Wird der alte 
Dateinamen nicht gefunden, wird dies, mit <Fehler: keine der- 
artige Datei zum Umbenennen (ge£funden)>, gemeldet und zum CCP 
zurückgekehrt. 
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* TYPE * Der TYPE-Befehl 
werk 


Syntax: 


TYPE filename (TFAGE NOPAGE)) 
Beschreibung: 


Mit dem TYPE-Befehl können Textdateien auf dem Bildschirm oder 
via CTRL-P auf Bildschirm und Drucker ausgegeben werden. 


Nicht für TYPE geeignet sind Dateien, die nicht druckbare Zeichen 
enthalten. (also Programmteile 0o.Ä.). Unter nicht abdruckbaren 
zeichen sind alle Zeichen zu verstehen, die nicht in der ASCII- 
Tabelle aufgeführt sind (Zeichen über 7FH), oder von der Bild- 
schirm- bzw. Druckerausgabe als CNTRL-Zeichen evtl. falsch inter- 
pretiert werden könnten (z.B. 00H...1FH). 


Als Erweiterung des CCP-Befehles wird von diesem bei Bedarf das 
Hilfsprogramm TYPE.COM aufgerufen. Mit der Erweiterung ist es 
möglich auch mehrere Textdateien nacheinander durch Eingabe von 
JOKERN passender Art mit einem Befehl auszugeben. 


Soll eine Datei gleichzeitig auf den Drucker ausgegeben werden, 
ist die Option NOPAGE nach einer eckigen Klammer, gefolgt von 
CTRL-P anzuhängen, um den Druckvorgang nicht durch die Bitte nach 
"press RETURN to continue' zu unterbrechen (dieser Text würde 
übrigens auch auf den Drucker ausgegeben werden). 


Es ist zugelassen auch nur TYPE einzugeben, in diesem Falle wird 
nach dem zu "'typenden' Dateinamen gefragt. 


Enter filenane: 


Beim 'typen' einer Datei kann durch CNTRL-S die Ausgabe der Datei 
angehalten werden. Weiter geht es nach CNTRL-Q. Nach jeder Ein- 
gabe von CNTRL-S kann mit CNTRL-P der Drucker zu oder abge- 
schaltet werden. Auch in diesem Falle geht es jedoch erst mit 
CNTRL-Q weiter. Abgeschaltet werden kann TYPE durch CNTRL-C. Der 
Drucker muß, nach Gebrauch, mit CNTRL-P wieder explizit abge- 
schaltet werden, 


Ist die Option PAGE wirksam, wird jeweils am Bildschirmende 
angehalten. Auch mit dieser Option bleibt die Kombination CNTRL- 
S, Q, P wirksam, am Bildschirmende wird dann jedoch zusätzlich 
angehalten, 
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Kapitel 4 Mehr Ordnung und Übersicht mit Hilfsprogrammen 


CP/M 3 stellt dem Anwender eine ganze Palette von Hilfsprogrammen 
zur Verfügung,um Dateien zu schützen oder zu markieren, Datum und 
Uhrzeit als Organisationshilfe einzubinden und Systemparameter 
bereits beim Booten einzugeben oder je nach Bedarf zu verändern, 


Eine sehr nutzvolle Eigenschaft ist die Tatsache, daß nach jedem 
Kaltstart (also nach jedem Booten) vom CCP geprüft wird ob eine 
Datei mit dem festgelegten Namen PROFILE.SUB auf der BootDiskette 
vorhanden ist. Ist dies der Fall, wird vor jeder weiteren Akti- 
vität ausgeführt, was in dieser Datei verlangt wird. Dies ist 
vorteilhaft, um die Suchordnung innerhalb der Laufwerke und von 
COM- und SUB-Dateien vorzugeben. Ebenfalls gesetzt werden kann 
die Option PAGE oder NOPAGE (Siehe hierzu SETDEF). Weiterhin kann 
erzwungen werden, daß Datum und Uhrzeit gesetzt werden. 


Bei manchen CP/M Systemen ist es möglich die Zeichensätze (eng- 
lisch-deutsch\) für die Bildschirmausgabe umzuschalten oder es 
kann veranlaßt werden, daß bereits nach dem Booten ein ganz 
bestimmtes Programm automatisch aufgerufen wird. 


Für den geübten CP/M 3 Kenner ist es so möglich, komplexe Vor- 
gänge quasi vorausschauend für einen Ungeübten zu übernehmen und 
diesem nur 'sein' Programm auf 'seiner' Diskette zuzuweisen. 


So ist es heute mit CP/M 3 sehr einfach, den Computer in Büros 
oder Kleinbetrieben nur für ganz bestimmte Aufgaben einzusetzen 
z.B. mit einem Text-Verarbeitungssystem für die Sekretärin, einem 
Buchhaltungsprogramm für die Fakturistin und einem Datenbank- 
System für den Chef. ohne daß der Benutzer CP/M überhaupt jemals 
bewußt zu Gesicht bekommt, 


Der System-Programmierer hat es mit PROFILE.SUB einfach in der 
Hand jedem Anwender die für ihn notwendigen Systemparameter auf 
ein im übrigen für alle geigneten Gerät anzupassen, ohne den 
Einzelnen mit Dingen zu belasten, die außerhalb seines normalen 
Interessenrahmens liegen. Es genügt dem Benutzer also vollständig 
die "Gebrauchsanweisung' eines bestimmten Programmes zu lesen und 
ein wenig zu Üben. Von CP/M braucht er dabei keinerlei Ahnung zu 
haben. 


Alle nachfolgenden Programme haben in irgendeiner Weise mit der 
Organisation und dem Schutz von Disketten und Dateien zu tun. Es 
sind Programme die Digital Research seinem CP/M 3-Paket beigefügt 
hat, um eine möglichst große Flexibilität zu erreichen. 


Viele dieser Hilfsprogramme werden nie in die Hände des "ein- 
£fachen' Anwenders gelangen und viele werden auch von routinier- 
testen Anwendern nicht benötigt. Es bleibt auf jedem Fall dem 
Anwender überlassen, was er auf seinen Arbeitsdisketten benötigt 
und was er nur als "stille Reserve‘ beiseite legt. 


Die Hilfsprogramme sind nachfolgend in alphabetischer Reihenfolge 
aufgeführt. Zur Vereinfachung der Syntaxangaben sind in Tabelle 6 
alle Syntaxregeln angegeben, soweit diese von allgemeiner Be- 
deutung sind. 
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Da es sich bei allen Programmen von der Bedeutung her mehr um 
Befehls-Erweiterungen handelt, werden sie in der Einzelbeschrei- 
bung auch als Befehle bezeichnet. 


4-—— + 

DIR DIRectory Attribut 

n eine beliebige Zahl innerhalb des zugelassenen! 
Zahlenbereiches 

o Bezeichnet eine Option 

RO READ-ONLY «(nur Lesen - nicht beschreiben ) 

RW READ-WRITE (Lesen und Schreiben) 

s Textzeile (String) 

SYS SYStem Attribut (Datei kann aus allen USER- 
Ebenen ereicht werden) 

..) Angaben innerhalb geschweifter Klammer sind 
optional,muessen also nicht angegeben werden 

[..] Angaben in eckigen Klammern sind Optionen, 


werden sie genutzt, muessen die eckigen 
Klammern mit angegeben werden. Die ab- 
schliessende Klammer kann (meist) entfallen 

Ü „== 9) Angaben eines bestimmten Eereiches werden 
innerhalb runder Klammern angeben. Die 
Klammern muessen angegeben werden. 

Gibt an, dass eine vorangegangene Angabe 
wiederholt werden kann. 

* oder CNTRL Gibt an, dass der nachfolgende Euchstaben 
zusammen mit der CNTRL-Taste gedrueckt werden 
muss. CNTRL-Zeichen koennen auf dem Eildschiırm! 
nicht anders dargestellt werden - sie dienen 
nur zu Steuerzwecken der Eildschirm- (oder 
Drucker-) Ausgabe. 

<cr? Repraesentiert die RETURN-Taste 

? JOKER bei der Angabe von Dateinanen, ersetzt 
jeden beliebigen Euchstaben 
+ JOKER er ersetzt alle nachfolgenden Buchstaben! 
innerhalb eines Dateinamens oder Index durch 
Fragezeichen. 

' trennt verschiedene Moeglıchkeiten in der 
Syntaxangabe. Es kann Jedach nur jeweils eine 
Moeglichkeit gewaehlt werden. 

! Trennt verschiedene Befehle in einer Befehls- 
zeile. (Wird von manchen Programmen, die 
Befehlserweiterungen in der Eefehlszeile zu- 
lassen, jedoch falsch interpretiert!!!) 


Tabelle 6 Abkürzungen und Symbole in den Syntax-Angaben 


29 


LA 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 227 


* COPYSYS * Der COPYSYS-Befehl 


WERKE KK HR KH KH a a 


Syntax: 
COPYSYS 
Beschreibung: 


Dieses Programm dient dazu, die vom Betriebssystem reservierten 
Systemspuren zu kopieren, 


Auf den Systemspuren befindet sich bei CP/M 3 lediglich der CPM- 
Loader, ein Programm. welches seinerseits die Datei CPM3.SYS, 
das eigentliche, benutzerspezifisch konfigurierte Betriexs-System 
lädt und nicht wie bei CP/M2, das komplette Betriebssystem. 


Dies gibt dem Benutzer die Möglichkeit, "sein' CP/M sehr schnell 
beinahe beliebigen Anforderungen anzupassen ohne auf die Größe 
des Programmes (paßt es auf die Systemspuren ?) achten zu müssen. 
Der Loader kann, einmal auf die hardware eines Systemes abge- 
stimmt, immer der gleiche bleiben. Er muß jedoch auf jeder Dis- 
kette, auf die gebootet werden soll. vorhanden sein | 


Die Datei COPYSYS.ASM wird allen von Digital Research zugelasse- 
nen Distributoren zur Verfügung gestellt, um hardware-spezifisch 
angepasst zu werden, Sie wird dann als COM-Datei (vielleicht auch 
unter anderem Namen) an den Benutzer weiter gegeben. 

eo 
Der Umgang damit ist sehr einfach wie das folgende Beispiel 
zeigt: 


Arcapysys 
Copysys Ver 3.9 


weher kopıeren ( oder <cr> fuer logın-Laufwerk ) :A 
kopieren von A aann (er) : <Ch) 

Funktion beendet 

wahın kopıeren ( oder cr) zum Abbruch ) ıB 
kopıeren nach B dann <er) : <CR) 

Furktıon beendet 

soll CFM2.SYS kopiert werden (J/N)? j 

woher kopıeren ( oder <cr> fuer logın-Laufwerk ) : <CR) 
kopieren von A dann <crd : <Ch> 

Funktion beendet 

» 


Anmerkung: 

Nicht alle Distributoren haben sich die Mühe gemacht den Ori- 
ginaltext in deutsche Sprache zu übersetzen - es kann also sehr 
wohl möglich sein, daß Ihr COPYSYS englisch 'spricht', der sinn- 
gemäße Inhalt ist aber der gleiche. 


Unter LOGIN-Laufwerk ist immer das Laufwerk zu verstehen, das vom 
Prompter des CCP's angezeigt wird. 
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* DATE “ Der DATE-Befehl 
Ka 


Syntax: 


DATE (c(ontinuous) 
DATE set 
DATE mm/dd/yy hh:mmıss 


Beschreibung: 


Mit dem DATE-Befehl ist es möglich, Datum und Uhrzeit zu stellen 
oder abzurufen. Dies setzt vom Prinzip her natürlich die ent- 
sprechende Hardware voraus, kann aber auch ohne diese Bedeutung 
haben. 


Es wird in jedem Falle das eingegebene Datum und die Uhrzeit 
abgelegt. Diese Daten bleiben im System erhalten bis zum Ab- 
schalten oder RESET. 


Befehlen oder Programmen, die diese Daten verwenden, stehen die 
eingegebenen Werte zur Verfügung, auch wenn die Uhr nicht 'läuft' 
(oder jedesmal von Hand gesetzt werden muß). Als Ordnungselement 
sind die eingegebenen Daten aber auch in diesem Falle immer noch 
zu verwenden. 


Die Eingabefolge ist leider "amerikanisch" wie aus dem Syntax zu 
ersehen ist. Es sind jedoch CP/M3 Systeme auf dem Markt bei denen 
DATE.COM zu DATUM.COM wurde, mit "deutschem' Syntax. ES handelt 
sich dabei um 'gepatchte' oder selbstgeschriebene Programme. 


Nachfolgend einige Beispiele und mögliche Fehlermeldungen: 
Ardate 


Fri 12/2785 11:08: 


Ardate set 
Enter toaay's date (MM/DG/YY):12/27/88 
Enter the time (mimıSS3: 11:15:66 


Press any key to set tıme 


Nach Eingabe des Datums in der Folge Monat, Tag, Jahr und der 
Uhrzeit in der Folge: Stunde, Minute, Sekunde (24-Stunden!) wer- 
den alle Daten erst nach Drücken einer weiteren, beliebigen Taste 
( 2... Press any key .. ) Übernommen, die Uhr kann also sekunden- 
genau gestellt werden. 


Es steht noch eine weitere Option zur Verfügung, ein 'C' oder der 
Text 'CONTINUOUS'. Sie ist nur sinnvoll, wenn eine Sekunden- 
anzeige zur Verfügung steht. Die Uhrzeit wird dann solange in der 
Befehlszeile ausgegeben, bis eine beliebige Taste gedrückt wird. 
Abgebrochen wird die Sekundenausgabe mit jeder Taste oder nach 
dem von Digital Research genannten Patch mit CNTRL-S - CNTRL-C. 
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* DEVICE * Der DEVICE-Befehl 
La 2 22 2 2 2 22 res 


Syntax: 


DEVICE (nanestvaluesiphysialische Einheit!l.gısche Einheit) 

CEVICE logısche Einheitzphysikalische Eirheit(öption){,phys-Einheit(o),... 
GEVICE logısche EinheitzNuLL 

DEVICE physikaliche Einheit (Option) 

GEVICE CONSOLELPageJCOLUMES=n!LINESSN 


Beschreibung: 


Mit DEVICE.COM ist es möglich die unter CP/M3 ansprechbaren fünf 
logischen EIN-/AUS-Gabe-Einheiten 


CONIN =Konsolen Eingabe 
CONOUT =Konsolen Ausgabe 
AUXIN =Zusatzkanal EIN 

AUXOUT =Zusatzkanal AUS 

LST (LIST) =Druckerkanal 


mehr oder weniger beliebigen anderen physikalischen Kanälen zu- 
zuordnen, 


Welche logischen Einheiten und welche physikalischen Einheiten 
vorhanden sind und wie diese belegt sind, ist durch den Befehl 
DEVICE schnell feststellbar: 


Argevıce 


Fhysical Devices; 

I=Input ‚ü=Öutput ,S=Serial, X=Xon-Kaff 

CENSOL 3609 103 VIDEO NÜNE 0 Con? #09 105 
FFRINT NONE 0 SPRINT 3600 08 SIOA 0 IS 
Sind 34 105 


Current Ässignments! 
CENIN: = CONSCL 


CENÖUTE = CONSÖL 
AUXIN: = CüN2 

AUKUTE = CON2 . 
LSTE = PPRINT 


Enter new assignment or hıt RETURN 


CONÖUTSCONSÖL , VIDEO 


Der Unterschied zwischen logischen Einheiten und physikalischen 
Einheiten ist recht einfach zu verstehen: 


Logische Einheiten sind die 5 Einheiten, die CP/M zuläßt: 

CONIN, CONOUT, AUXIN, AUXOUT und LST. 
Unter physikalische Einheiten versteht man die Einheiten, welche 
auch wirklich (... eben physikalisch) vorhanden sind und mit 


einem entsprechenden Treiberprogramm (das die Ein/Ausgabe auch 
ermöglicht) in die Datei CHARIO eingebunden sind, 
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Es sind theorethisch 16 physikalische Einheiten möglich, prak- 
tisch sind jedoch nur 14 Einheiten zugelassen (zwei Zuweisungen 
sind als Reserve vorgesehen). 


Die Namen der logischen Einheiten sind unveränderbar, während die 
Namen der physikalschen Einheiten dem Benutzer (zumindest jedoch 
dem Programmierer) überlassen bleiben. Die Namen der logischen 
Einheiten sind hierfür jedoch nicht zugelassen, 


Meist werden Namen gewählt die (in Steckkarten-Systemen eine 
bestimme Systemkarte oder) einen bestimmten Baustein bezeichnen, 
z.B. SIO oder Namen, die einen bestimmten Zweck der Schnittstelle 
andeuten, z.B. MODEM, 


Die nachfolgenden Beispiele zeigen die Anwendung des Befehls. Die 
möglichen Optionen sind in Tabelle 7 zusammen gefaßt. 


Fehler, die eine unzulässige oder physikalisch unmögliche Zuwei- 
sung betreffen, werden angezeigt, wie im Beispiel der AUX-2u- 
weisung, wenn z.B. eine Baudraten-Umschaltung (software-mäßig) 
nicht möglich ist, 


Die Umschaltmöglichkeiten hängen immer davon ab, ob das ent- 
sprechende Gerät auch physikalisch (also greifbar) vorhanden ist; 
die Umschaltung der Baudrate davon, ob diese über Software ge- 
steuert werden kann. Auskünfte gibt normalerweise das Benutzer- 
handbuch des CP/M-Gerätes oder die bereits schon genannte Datei 
CHARIO, 


A>DEVICE AUXIN:=SIOZELXON, Im) 
Error at tne '*'; Baud rate can nat be set for tnıs device 
ADDEVICE consolelcolumns=46, lines=i6) 


Console width set to 4& columns 
Console page set to 16 lines 


Ardır 

A: STATLINE ING : DISKIO  REL 
A: CPM3 SYS ı BOOT REL 
A: BNKEIOS3 SPR : SCB 220 
A: ZERASM Com : DISKIO  BAK 
A: STIME INC : RESEDOS3 SPR 
A: BNKEDOS3 SPR : GENCPM DAT 
A: CHARIO Re : EIOSKRNL Ze 
A: SUB SUB : CLOCKI INC 
A: CFM3 INC : ReCALL COM 
A: HOISK INC : BOOT 25 
A: INS) ı FEIGS REL 
A: CLOCK2 INC: MOVE ReL 


» 
= 


Nach der Umschaltung auf 40 Spalten und 16 Zeilen, zeigt der DIR- 
Befehl deutlich. was mit dieser Umschaltung erreicht wurde: die 
DIR-Ausgabe ist nur noch halb so 'breit'. 
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CONIN! Konsolen Eingabe (Tastatur oder Terminal). 

CONOUYT : Konsolen Ausgabe (Bildschirm oder Terminal). 

AUXIN: AuUXiliare (allgemeine, zusätzliche) ScHnitt- 

AUXOUT: stelle, z.B. zur Verbindung mehrerer Computer 
oder als MODEM-Schnittstelle gedacht. 

LST: Druckeranschluss. 


NAMES Es werden die Namen aller belegeten phy- 
sikalischer Einheiten und deren Charakter- 
istik ausgegeben. 

VALUES Es wird die augenblickliche Zuweisung der 
logischen Einheiten ausgegeben. 

phys Einheit Es werden alle Attribute der genannten phys. 
Einheit ausgegeben. Mögliche Namen sind 
in der BIöOS-Datei CHARIO deklariert. 

log Einheit Es werden alle Attribute und Zuweisungen der 
genannten logischen Einheit ausgegeben. 
Mögliche Namen siehe oben. 


Einstellbare Optionen: 

KON Für die benannte Einheit wird ein XÖN/XÖFF- 
Protokoll benutzt. 

NOXÖON Für die benannte Einheit wird kein XÖN/XÖFF- 
Protokoll benutzt. 

nnnn Für die benannte Einheit wird die Baudrate 
nnnn benutzt. Es sind folgende Baudraten zu- 
gelassen! 


59,75,118,134,150,200,699,1200 
1300, 2460, 36500, 4560, 7200, 9600, 19209 


Die Baudrate kann nur geändert werden, wenn 
dıes in der BIÖöS-Datei CHARIÖO ausdrücklich 

zugelassen wird, in diesem Fall muB ein ent- 
sprechender software-Treiber vorhanden sein 


Tabelle 7_ Zuweisungen und Optionen des DEVICE-Befehles 
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* DUMP “ Der DUMP-Befehl 
Wr a Eh 


Syntax: 
DUMP filename, ext 
Beschreibung: 


Genaugenommen handelt es sich hier nicht um einem Befehl,sondern 
um ein Programm, das zur schnellen Überprüfung von Dateien, die 
nicht als Text-Dateien zur Verfügung stehen, dient. 


'Ältere' Programme erlauben nur eine Darstellung im HEX-Format. 
Neuere Programme stellen die Daten in HEX- und ASCII dar. Die 
Option PAGE oder NOPAGE ist bei den meisten Programmen dieser Art 
wirkungslos, weiter geht es meist auch NUR mit der Return-Taste, 
falls diese Option überhaupt vorgesehen ist. 


In Teil IV (Beispiele und Anwendungen) ist ein DUMP-Programm als 
Listing abgedruckt. 


A’dımp ws.com 

(P/M 3 DIMP - Version 3.6 

BOB RLE II DEE m. 
enih: 18 06 AU Hu 66 00 00 26 ZU AB Ar SB SI 5ZAIUT ....... COPYRIG 
RE EUHAREZEIZARAHENARARMEIE HT IE Kıc 
on: Ta GE SA TAGE 20 AI GE 74 65 72 KE EI 7469 GEF roPro Internatio 
ea: BEE EC MAREF 72 7a 6F 72 EI 74 ES EF EE Z& nal Corporation 
AS: 20 OF 66 20 26 AD 69 63 72 BF SM TZRF u 57 6F Nıcrofro Wa 
ensnı 7264 53 74 61 72 20 U 72 ES EL ES EI 7265 M rdStar release 
10: 32 309 20 20 7265 7269 61 BC 6 23 m 57 3.00 serial #W 


35 


WER a a a 


* GENCOM * Der GENCOM-Befehl 
WER 


Syntax: 
GEMGM (COM-Dateinane) {RSt-Dateinane).. .(LLOADER:NULLISCHSÜoffset ‚vert)]) 
Beschreibung: 


Mit diesem Befehl ist es möglich, RSX-Dateien an ein Programm 
anzuhängen oder wieder abzuhängen, 


Die Funktion und der Zweck von RSX-Dateien kann sehr vielfältig 
sein. An dieser Stelle sei nur erwähnt, daß es sich bei RSX- 
Dateien (Resident System eXtensions) um eine CP/M 3 spezifische 
Möglichkeit handelt, ganz bestimmte anwendertypische Erweiter- 
ungen des BDOS oder des BIOS in das System zu integrieren. 


RSX-Dateien werden vor den Beginn des residenten (ungebankten 
Teiles) des BDOS geladen, die BDOS-Einsprungadresse auf Adresse 5 
(in der TPA) wird ebenfalls auf eine entsprechende Adresse in der 
RSX-Datei umgeändert. Vor jedem BDOS-Aufruf kann nun im RSX- 
Programm geprüft werden, ob evtl. vor (oder nach) dem Aufruf 
irgendetwas veranlaßt werden soll. 


Die vielfältigen Möglichkeiten werden dem geübten Programmierer 
schnell ins "Auge springen', den Anfänger jedoch nur völlig 
verwirren. Es sei daher auf Teil III verwiesen, in dem näher auf 
die Möglichkeiten von RSX-Dateien eingegangen wird. 


Das "Anhängen' einer RSX-Datei ist nur an COM-Dateien möglich 
(Also an Dateien, die prinzipiell selbstständig ablauffähig 
sind). 


Das folgende Beispiel zeigt das Anhängen des RSX-Programmes RSX22 
(einer CPM2 Emulation für bestimmte Anwendungen) an das Programm 
SUPERZAP.COM, 


Soll der RSX-Teil wieder abgehängt werden, so wird lediglich das 
entsprechende Programm noch einmal über GENCOM aufgerufen, dann 
aber ohne Namensangabe des RSX-Programmes, 


Azancım suparzap rax22 
A: zancon superzap 


Es können auch mehrere RSX-Programme an eine COM-Datei angehängt 
werden, wie folgendes Beispiel zeigt: 


A’gencon myfıle test] test2 


Neben dem Anhängen eines RSX an eine COM-Datei, ist es auch 
möglich, aus einer RSX-Datei sofort eine COM-Datei zu generieren: 


Argencem rsx22 test2[null] 


In diesem Falle wird eine Datei RSX22.COM generiert, die aus den 
RSX-Dateien RSX22.RSX und TEST2.RSX bestehen. Wird RSX22.COM 
danach aufgerufen, "legt' es sich vor das BDOS und bleibt (je 
“a Konfigurierung) für alle später aufgerufenen Programme 
wirksam. 
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Es bestehen mit GENCOM noch zwei weitere Möglichkeiten Dateien 
umzu-'bauen', zum Beispiel mit: 


Agencon filenanelloader] 


Hier wird vor die Datei <filename> ein sogenannter Header (Kopf) 
eingebunden, während mit dem folgenden Beispiel: 


Agencon: filenamelsch=(1,5)) 


nach Aufruf der Datei <filename> zuerst das Byte 1 im SCB auf den 
Wert 5 geändert wird. 


Die Nutzanwendung beider Möglichkeiten soll ebenfalls in Teil III 
zur Sprache kommen. 
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LES 2 2 2 2 2 2 2 2 2 2 2 2 2 22273 


* GET * Der GET-Befehl, 
WER a a a a 


Syntax: 


6ET (console input from) FILE fılnane (LIECM!N) ECHd) ISYSTEMJ) 
GET (console ınput, from) CONSOLE 


Beschreibung: 


Der GET-Befehl ist in gewisser Weise verwandt mit dem SUBMIT- 
Befehl. Hier können Befehlsketten beliebiger Länge aus einer 
Datei auf Diskette abgerufen werden. 


wenn die Disketteneingabe beendet ist, zur Abarbeitung jedoch 
noch weitere Daten benötigt werden, so werden diese von der 
Konsole erwartet. . 


Arget file make 
Arnyprog 


In diesem Falle wird die Datei MAKE als Befehlsdatei spezi- 
fiziert. Da jedoch die Option SYSTEM nicht angegeben wurde, wird 
zunächst auf eine weitere Konsolen-Eingabe gewartet. Alle von (im 
Beispiel) MYPROG.COM benötigten Daten werden nun von der Datei 
MAKE übernommen. 


Nach Beendigung des Programmes MYPROG geht CP/M wieder zum 'nor- 
malen Tagesgeschehen' über, d.h. GET ist nicht mehr aktiv. Wird 
ein Programm jedoch wie folgt aufgerufen: 

Arget fıla tastıtlsystem] 


so wird jede weitere Eingabe von der Datei TESTIT übernommen. Es 
wird nur nach dem Befehl: 


GET CONSOLE 

in den Normalbetrieb zurückgekehrt. Dieser Befehl muß in der GET- 
Datei enthalten sein oder kann (erst) nach dem vollständigen 
Abarbeiten der GET-Datei über die Konsole eingegeben werden. 


Optionen ECHO und NO ECHO geben an, ob alle Befehle aus der GET- 
Datei heraus auf der Konsole 'geechot' werden oder nicht. 
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ES Erz 2 2 2 2 2 2 2 2 2 2 2 2 2 2; 


* HELP ir Der HELP-Befehl 
WER 


Syntax: 


HELP (Begriff)(Imterbegriffl interberoritfZ .. .)ELNO PAGESPAGEI) 
HELP [extracticreate] 


Beschreibung: 


Der HELP-Befehl ist als Gedächnisstütze und Hilfe gedacht, wenn 
der Syntax eines Befehles vergessen wurde. 


Leider ist die in HELP von Digital Reseach mitgegebene Infor- 
mation nicht ausreichend und darüberhinaus auch noch in engli- 
scher Sprache, 


Alle Texte stecken in einer Datei mit der Bezeichnung HELP.HLP 
und werden ihrerseits von der Datei HELP.COM entsprechend dem 
Suchbegriff und einem evtl. Unterbegriff ausgesucht und darge- 
stellt. 


Die Darstellung erfolgt seitenweise (mit der Option PAGE) oder 
durchgehend (mit der Option NO PAGE).. 


Es besteht jedoch die Möglichkeit die Datei HELP.HLP nach Be- 
lieben abzuändern, zu kürzen oder zu ergänzen, ( ... auch in die 
deutsche Sprache zu übersetzen ... ) 


Hierzu sind zwei Optionen wichtig: 
EXTRACT (oder einfach 'E') hiermit wird der Header (Kopf) der 


Datei HELP.DAT entfernt. Diese Datei kann nun mit 
jedem Editor wie eine normale Textdatei bearbeitet 


werden. 

CREATE (oder einfach 'C') hiermit wird die Textdatei wieder 
in eine von HELP.COM direkt aufrufbare Datei zurück 
gewandelt. 


Sollen die Möglichkeit der Bearbeitung, Veränderung oder EI- 
weiterung der Datei HELP.DAT genutzt werden, so ist genau auf den 
vorgeschriebenen Syntax zu achten. Am besten betrachte man sich 
die HELP.HLP Datei als Beispiel. 


In der HELP-Datei muß für jeden Begriff ein 'Kopf' eingeführt 
werden in der Form: 


///nBegriff<CR> 
Die Zeichen: 
//I melden, daß nun ein neuer Begriff kommt 
n symbolisiert den Rang des Begriffes. 
N=1 ist immer der Oberbegriff, Zahlen im Bereich 


von 2..9 symbolisieren immer tiefer gestaffelte 
Unterbegriffe mit dem Namen 'Begriff'. 
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Folgende Aufrufe von HELP.COM sind möglich (wie von Digital Re 
seach geliefert): 


Abhelp 
Ahelp date 
A:raip sır cptiors 


wobei die 


l.Eingabe eine Reihe von Möglichkeiten im Menü 
anbietet, die 

2.Eingabe Informationen zum Befehl DATE gibt und die 

3.Eingabe alles zu den Optionen des Befehls DIR 
ausgibt. 


nach jeder Ausgabe meldet sich dieses Programm mit 

NEL» 

als Prompter in der Befehlszeile. 

Es kann nun nach weiteren Befehlen, Optionen usw. gefragt werden, 
ohne daß die Datei HELP jedesmal neu geladen werden muß (sie ist 


ja schon geladen). 


Ein <CR> beendet HELP-Befehl. 
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aha a 


* HEXCOM * Der HEXCOM-Befehl 
PeeTTP POTT Enn 


Syntax: 
KEYCOM (di )fıienarz 
Beschreibung: 


Mit diesem Hilfsprogramm werden aus Dateien im INTEL-HEX-Format 
ablauffähige 'COM'-Dateien generiert. 


Derartige HEX-Dateien werden z.B. von dem mit CP/M 2 gelieferten 
Assembler ASM.COM oder dem mit CP/M 3 gelieferten (Macro) -Assem- 
bler MAC.COM erzeugt. Die assemblierten Programme müssen selbst- 
verständlich wie unter CP/M üblich für die Startadresse L100H 
ausgelegt sein. 


HEXCOM sucht NUR nach Dateien mit dem Index HEX. Dieser Index 
braucht nicht eingegeben werden. 


Zur Information nachstehend ein Auszug aus einer HEX-Datei, um 
auch dies einmal darzustellen: 






2 
TR 7CE867 
Io ra ı_ Fruefsunme 
114 16 (1043 Bytes Daten in ASCII-Format 

{ 4, Kennzeichen (8) fuer 'normale‘ KeX-lateı 

ı_ Startadresse oes ersten Bytes in der Zeile (LOW-Eyrte-kißtEyte Fornat 
_ Anzahl der Datenbytes in jeoer Zeile 
_ $tarinarke einer neuen Daterzeile 


ala FF Dies ist eıne Abschlusszeile nıt Angane ger Startagresse 
(1@ör in LöW-Byte Kißr-Byte Format) und oer Fruefsume. 
Dıe Fruefsunne ist nichts anderes als cıe fortlautense 
Subtraktion (von @% beginnend) aller Eytes (ausser oen- 
Doppelpunkt) in einer Zeile. Das emptangende Program 
addıert zu dıeser Pruefsunme alle empfangenen Eytes. Das 
Ergebnis muss 6 sein, wenn der Empfang fehlerfrei var. 


Alle HEX-Dateien beginnen mit einem Doppelpunkt <:> danach folgt 
eine Angabe (in Hexadezimal) über die Anzahl der Datenbytes in 
einer Zeile (10H=16dezimal). 


Nach dieser Angabe folgt die Adresse, wohin das erste Byte einer 
Zeile geschrieben werden soll (ebenfalls in Hexadezimal). 


Es folgt ein Kennbyte: 00=Normale Daten, Ol=Sonderdatei o.Ä. 
Nun folgen soviele Datenbytes wie in Position 2 angegeben wurden. 
Als letztes wird ein Byte ausgegeben, das die Summe aller ge- 


sandten Zeichen in dieser Zeile (ohne dem Doppelpunkt) enthält. 
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Ein evtl. "Überlauf' wird dabei unterschlagen. Diese Prüfsumme 
(Checksum) ist ebenfalls in Hexadezimal, 


Alle Daten in einer HEX-Datei werden im ASCII-Format übergeben, 
da diese Dateienart ursprünglich vor allem für den Datenverkehr 
zwischen verschiedenen Computern gedacht war und die e.:csprech- 
enden Computerschnittstellen nur im (7-Bit) ASCII-Format senden 
und empfangen konnten. Anstelle von handshake-Signalen wurde 
Textanfang und Textende durch entsprechende CNTRL-Zeichen er- 
kannt. Das Textende in Dateien wird auch heute noch von den 
meisten Editoren mit lAH (EOT=end of text=Textende) markiert. 


HEX-Dateien können mit TYPE-Befehl auf der Konsole ausgegeben 
werden, 
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LEITI IS 22 2 2 2 2 2 2 2 2 2 20: 


* INITDIR » Der INITDIR-Befehl 
LLTPTTTTTIIIIT In T 


Syntax: 
INITDIR di 
Beschreibung: 


Mit INITDIR kann das Inhaltsverzeichnis einer Diskette darauf 
vorbereitet werden, Datumsmarken und einen Diskettennamen aufzu- 
nehmen, 


Dies geschieht wohlgemerkt NICHT mit INITDIR selbst, sondern mit 
dem Hilfsprogramm SET.COM. INITDIR hat lediglich eine ähnlich 
Aufgabe wie die Formatierung einer Diskette, nämlich die For- 
matierung des Platzes für das CP/M 3 typische, erweiterte In- 
haltsverzeichnis vorzunehmen. 


Bei INITDIR wird folgender Dialog ausgegeben: 


Arinıtdır bi 


INITDIR WILL ACTIVATE TIME STAMFE FÜR SFECIFIED DRIVE. 
Do you want to re-format the aırectory on drive: BE (Y/N? y 


Da yau want the existing date/time stanps cleareg (Y/N) y 


Übersetzung: 


INITDIR AKTIVIERT DIE ZEITMARKEN FÜR DAS ANGEGEBENE LAUFWERK 
Soll das Inhaltsverzeichnis in Laufwerk B um-formatiert werden 
(Ja/Nein) 


hat die Diskette bereits ein erweitertes Inhaltsver- 
zeichnis, so wird abgefragt: 


Sollen die existierenden Zeitmarken gelöscht werden (Ja/Nein)? 


An dieser Stelle soll der Vollständigkeit halber die Auswirkung 
des erweiterten Inhaltsverzeichnises erwähnt werden. 


Jeweils für drei Einträge im Inhaltsverzeichnis wird ein zu- 
sätzlicher Eintrag reserviert. In diesem Eintrag werden nun alle 
entsprechenden Daten wie Zugriffsdatum und Uhrzeit, aber auch ein 
mögliches Paßwort (natürlich verschlüsselt) vermerkt. 


Um keine Probleme mit dieser Art des Eintrages unter CP/M 2 zu 
haben, ist das erste Byte des zusätzlichen Eintrages ein 21H, 
während ein (möglicher) Diskettenname (ein Disketten-Label) durch 
ein vorangestelltes 20H erkennbar ist (näheres hierzu in TEIL III 
und TEIL V). CP/M 2 interpretiert übrigens DIR-Einträge mit 
vorangestelltem 20H oder 21H als "leer'-Datei. 


Es ist dabei besonders wichtig zu wissen, daß die Anzahl der 


effektiven Einträge in das Inhaltsverzeichnis um ein Viertel (und 
dem DIR-Label) der möglichen Einträge reduziert werden, wenn ein 
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erweitertes Inhaltsverzeichnis benutzt wird. 

Da bei den heutigen Diskettenformaten mit doppelter Dichte und 
auf Harddisks genügend Speicherraum zur Verfügung steht, um das 
Inhaltsverzeichnis ohne Probleme auf 1024 Einträge zu erweitern 
(dies entspricht einem belegten Speicherplatz von 32k), dürfte 
dies kein Problem darstellen, 
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LE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 


* PATCH * Der PATCH-Befehl 
RE a 


Syntax: 

PATCH filenane.{ext} {n} 

Beschreibung: 

Dieser Befehl dient eigentlich nur der '"Buchhaltung', ob Fehler- 
meldungen, die Digital Research von Zeit zu Zeit veröffentlicht, 
bereits korrigiert wurden. Soll z.B. festgestellt werden, ob in 


dem Hilfsprogramm SHOW.COM ein "patch' und wenn ja welcher, 
installiert wurde, so wird dies einfach wie folgt abgefragt: 


Arpatch show 


Current patch for Smw4.COM 
None 


m 


Wurde ein neuer "patch' installiert, so kann dieser wie folgt 
übertragen werden: 


Arpatch show 1 


Do you want to indicate that Patch # | 
has been installed for Smünt.Com? y 


Patch ınstalied 


A 


Patch wird *"nur' mit maximal 32 Fehlermeldungen fertig. 


Anmerkung: 

Die eigentliche Korrektur wird dabei nicht von PATCH.COM über- 
nommen, sondern muß nach Anweisung von DIGITAL RESEARCH oder dem 
zuständigen Distributor vorgenommen werden, zumeist mit Hilfe von 
SID.COM. 


PATCH ist nur für COM-Dateien verwendbar. 
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LESTTETTI Teer ren 
* ‚PUT. * Der PUT-Befehl 


LE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 zo 


Syntax: 
PUT CONSOLE:PRINTER (output to) CONSÖLEIFRINTERFILE filenasel[o]) 
Beschreibung: 
Mit dem PUT-Befehl ist es möglich,alle Ausgaben, die normaler- 
weise auf dem Bildschirm erscheinen, auf eine Datei oder den 
Drucker umzulenken. 
Dieser Befehl ist vor allem für Protokolle geeignet z.B. bei 
längeren Assemblier- und Linkaufgaben, bei welchen festgehalten 
werden muß, wie das generierte Programm zusammengebunden wurde. 
Es können zwei Quellen spezifiziert werden: 

a) die Konsole oder allgemein CONOUT 

b) der Drucker oder allgemein LST 
Als Ziel sind 3 Einheiten möglich: 

a) Eine Datei (spezifiziert als <filename>) 

b) Der Drucker (wenn Ausgabe über CONOUT erfolgt) 

c) Die Konsole (wenn Ausgabe über LST erfolgt) 
Dazu stehen 5 Optionen zur Verfügung: 


a) ECHO oder NO ECHO steuert die zusätzliche Wiedergabe 
auf dem Bildschim. 


b) FILTER oder NO FILTER. Wird FILTER angegeben, werden 
alle Steuerzeichen mit einem vorangestellten '*' 
ausgegeben, bei NO FILTER werden sie ausgegeben 
wie sie sind, 


c) SYSTEM veranlaßt, daß ALLE folgenden Daten (auch Echo) 
an das angegebene Ziel ausgegeben wird. 


Nach der Option SYSTEM kann nur mit einer Rücküberweisung in den 
Normalbetrieb zurückgeschaltet werden, wie nachfolgendes Beispiel 
zeigt: 


Aput console output to file holditlechn, systea] 
Arput console output to cansale 


Nach Eingabe der 1. Zeile, werden alle weiteren Ausgaben, die der 
gewünschte Programmablauf mit sich bringt (wegen ECHO), auf dem 
Bildschirm dargestellt. Wird jedoch die Option NO ECHO gewählt, 
so muß der Befehl zum Zurückschalten 'blind' eingegeben werden. 
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DIE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 20: 


* SAVE * Der SAVE-Befehl 
wre Eh‘ 


Syntax: 
SAVE 
Beschreibung: 


Unter CP/M 2 war der SAVE-Befehl noch im CCP eingebaut. Da unter 
CP/M 3 der CCP ein Programm im üblichen Sinne ist, wird der 
Bereich ab Adresse 100H bei jedem Warmstart vom CCP überladen, 
bevor eine dort befindliche Datei "gerettet" werden kann. 


Die SAVE-Funktion wird normalerweise nur bei Fehlerkorrekturen 
von Dateien benutzt; sie hat also einen recht eingeschränkten 
Zweck. Normalerweise wird unter CP/M 3 mit dem mitgelieferten 
Programm SID.COM gearbeitet, das eine SAVE-Funktion enthält. SID 
hat für Besitzer eines Z280-Computers jedoch einen entscheidenden 
Nachteil - er 'versteht' nur die INTEL (8080) Mnemonics. 


Benutzer, die mit ZSID.COM oder einem anderen CP/M 2 kompatiblen 
Debugger arbeiten, können Dateien zwar korrigieren, entwanzen 
oder was immer, aber danach nicht auf Diskette zurückschreiben. 
Mit dem SAVE-Befehl wurde jedoch ein entsprechendes Hilfsmittel 
zur Verfügung gestellt. 


Das folgende Beispiel zeigt seine Einsatzmöglichkeiten: 


Adsave 
Azsıd nyprog.com 


ı Jetzt koennen Aenderungen verganomeen werden 
i ... dann zurueck ins Betriebssyste@ mıt . 


LE 

SAVE Ver 3.0 

File (or RETURN to exit)?eyprogl.com 
Delete myprogl.com? y 

From?166 

To?5ad 


Lv 


Der SAVE-Befehl kann auch direkt aus der Befehlszeile heraus 
verwendet werden, (durch zweimaliges Aufrufen) In diesem Falle 
muß jedoch berücksichtigt werden, daß zumindest die unteren A4K 
(also bis Adresse 1100H) ungültig, d.h. überschrieben sind. Es 
kann jedoch jede beliebige höhere Startadresse (in HEX!!!) ange- 
geben werden, natürlich auch der Datenblock ab Adresse 0, falls 
dortige Daten in gewissen (Test) Fällen von Bedeutung sind, diese 
Daten können dann mit z.B. DUMP betrachtet werden. 


Anmerkung: das Public-Domaine Programm DDTZ entspricht etwa ZSID 
kann jedoch auch Dateien 'saven',. 
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WERKE a a a a a 


* SET * Der SET-Befehl 
WER a a a a a 


Syntax: 


SET (4!) (filename)[optionen] 


Beschreibung: 


Mit dem SET-Befehl steht eine reiche Auswahl von Möglichkeiten 
der Disketten- und Dateienorganisation und des Disketten- und 
Dateienschutz zur Verfügung. Alle Optionen sind in Tabelle 8 
zusammengefaßt. 


l. Setzen von Datei-Attributen. 


Mit diesen Optionen ist es möglich Dateien als DIR- oder sSYS- 
Datei zu erklären. Weiterhin kann eine Datei als RO- (read-only - 
nur lesen) Datei gesetzt werden. Ein unbeabsichtigtes Löschen 
einer derartigen Datei ist also recht wirkungsvoll verhindert, 


Neben einem Archiv-Attribut, können noch 4 weitere Attribute 
gesetzt werden. Das Archiv-Attribut ermöglicht es mit dem Pro- 
gramm PIP.COM nur solche Dateien zu kopieren, die dieses Attribut 
noch nicht gesetzt haben. Die Attribute Fl..F4 können persön- 
lichen Zwecken dienen (siehe hierzu auch die Optionen bei DIR). 
Die letztgenannten Optionen sind vor allem für Großsysteme von 
Interresse, wo viele Dateien gleichzeitig auf einer Harddisk 
vorhanden sind und die Übersicht sonst leicht verloren gehen 
kann. 


Arset k.comlsys] 


A:FORMAT „COM set to system (SYS), Read Write (RW) 
A:CCP .CiM set to system (SYS), Read Write (RW) 
Au Com set to system (SYS), Read Write (RW) 
A:5i0 .CöM set to system (SYS), Read Write (RW) 
A:UHTE  .Cüm set to system (SYS), Read Write (RW) 
A:SETGEF COM set to system (SYS), Read Write (RW) 
A:INITDIR ‚COM set to system (SYS), Read Yrite (RW) 
A:TIFE COM set to system (SYS), Read Write iRY) 
A:0iR ‚Cu set ta system (SYS), Read Write (Ay) 
A:GENEPM .CoM set to system (SYS), Read Write (RW) 
AISET Com set to system (SYS), Read Write (RW) 
N:ZSID COM set to systen (SYS), Read Yrite (RW) 


» 
Alle folgenden Optionen bedürfen der "vorherigen Behandlung' der 
Diskette mit INITDIR. 


Es soll auch an dieser Stelle nicht unerwähnt bleiben, daß die 
Anzahl der möglichen Einträge in das Inhaltsverzeichnis durch die 
Option INITDIR um ein Viertel verringert wird. 


Dateien die mit INITDIR und den nachfolgenden Optionen behandelt 


wurden, werden im Inhaltsverzeichnis mit Uhrzeit und Datum abge- 
legt, Angaben darüber sind mit dem DIR-Befehl zu erhalten. 
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2. Zuweisung eines Namens für eine Diskette 


Dieser Namen kann aus dem Inhaltsverzeichnis heraus (durch eine 
vorangestellte 20H) erkannt werden. Er dient hauptsächlich Ord- 
nungszwecken. 


Adset b:[nanestexte.@1] 
Label for drive B: 


Directory Fasswdis Stanp Stanp Stamp 
Label Read Create Access Upsate 


B:TENTE el off off off off 





3. Zuweisung von Zeitmarken für eine Diskette 

Zeitmarken sind sinnvoll. um aus dem Inhaltsverzeichnis den Ter- 
min des letzten Zugriffes auf eine Datei, seine Veränderung oder 
Entstehung erkennen zu können. 


Die beiden Optionen CREATE (Entstehung) und ACCESS (Zugriff) 
können wahlweise, jedoch nicht gemeinsam verwendet werden. 


CREATE ist sinnvoll für Programmierer, um zu wissen wann eine 
Datei entstanden ist, während ACCESS sinnvoll ist, wenn nachge- 
halten werden muß, wann auf eine Datei zuletzt zugegriffen wurde. 


Ob und welche Option sinnvoll ist muß, der Benutzer selbst ent- 
scheiden. 


Als zusätzliche weiter Option steht UPDATE (Erneuerung) zur Ver- 
fügung. 


Adset bilcreate=on,update=on] 


Label for drıve B: 











Directory Passwis Stanp Stanp  Stamp 
Label Reqd Create Access Ihaate 
E:TEXTE Mel otf on otf on 


Ein Hinweis an dieser Stelle: 


Textverarbeitungsprogramme legen normalerweise eine BAK Datei 
(quasi als Rücklage für den Fehlerfall) an. Hier liegt eine 
Fehlerquelle besonderer Art. Im Inhaltsverzeichnis dürfen (laut 
Vereinbarung) Dateien keine gleichen Dateinamen und gleichen 
Index haben. Im obigen Falle wird dies damit umgangen, daß (in 
den Textverarbeitungsprogrammen) die vorhandene Datei vor dem 
Ablegen der neu bearbeiteten Datei in <datei>.BAK umbenannt wird. 
Erst dann wird eine neue Datei ( mit dem alten Namen) angelegt. 
CP/M interpretiert dies jedoch IMMER als das, was es ist, das 
Ablegen einer neuen Datei - mit einer neuen Zeitmarke. Da aber 
die BAK-Datei ebenfalls neu angelegt wird ( eben durch die Umbe- 
nennung), wird sie folgerichtig ebenfalls mit einer neuen Zeit- 
marke versehen. 
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4. Zuweisung eines Paßwortes (Kennwort) 


Mit einem Paßwort kann eine Diskette vor 'fremdem' Zug:iff in 
verschiedenen Ebenen geschützt werden. Um einer Diskette oder 
einer Datei den Schutz durch ein Paßwort zu geben, sind verschie- 
dene Vorgänge notwendig: 


das Paßwort muß mit der Option PASSWORD zugewiesen 
werden, 


Die Ebene des Schutzes (READ-WRITE-DELETE) muß de- 
finiert werden, 


Der Schutz muß freigegeben werden. 
Dieser sicherlich etwas umständliche Vorgang ist nachfolgend 
wieder an Hand einiger Beispiele dargestellt. Die Option DEFAULT 
erlaubt dem Kenner des benutzten Paßwortes einen gewissermaßen 
unbeschränkten Zugriff auf eine Diskette, solange diese nicht 
gewechselt oder das System neu gebootet wird. 
E}set (passworg=geheia] 


Label far drive EB} 





Directory Fasswes Stanp Stamp  Stanp 

Label Ragd Create Accass Ipmate 
BeTcHtE Mel ff on off on 

Fassword = oEHEIM X GEHEIM ist das neue Passwort 


Brsetlsefault=geneim] 
Getault passworg = GEHEIM < wurde als Gional gesetzt 


Biset[protact=on] 


Label far drive B: 














Directory Passwis Stamp  Stamp Stamp 
Label Read Create Access Update 
B:TEITE 1 on on off on 

ı_ der Passwortschutz ist eingeschaltet 


Bisetl[protectzoff] 


Label for drive B: 


Directory Passwis Stap Stamp Stamp 
Label Read Create Access Update 











BITTE .M arf on orf on 


ı_ der Passwortschutz ist ohne Nachfrage ausgeschaltet 
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B)set [defaultznone] 
Default password = NONE < DEFAULT wırd ausgeschaltet ... 
Böset [protect=on] < und oer Passwortschutzt wieder eingeschaltet 


Directory Label 
Fassword ? geheis dazu wird bereits das (frueher zugewiesene) 


Passwort benoetiat. Die Eingabe erfolat Omhe ELnö! 


Label for drive B: 


Directory Fasswis Stanp Stanp Stanp 
Label kegd Create Access Update 











B:TEITE ‚el on on off on 
ı_ oer Fasswortschutz ist wieder eingeschaltet 


Eiset[protert=off) < und soll nun wieger abaeschaltet weroen 


Directory Label < dıeses mal wird abgefragt 

Password ? hugo < ein falsches Fasswort ('blind’ eingegeben) 
ERRÖR! Wrong Password < wırd auch gemeldet 

Cirectory Label 

Edset[protectzotf] < nochmal 


bırectory Label 
Fassword ? gehein < mt dem rıchtigen Passwort den Schutz aufheben 


Label for drive B! 


Directory Passwss Stanp Stanp Stanp 
Label Read Create Access Upmate 


E:TENTE wel off off off off 
!_ cıeses mal ist der Schutz autgehaben wargen 


B)set [passworg=mne] 


Directory Label 
Fassword ? gehein X auch zum Zurvecknehmen eines Fasswortes 

< wird es, einmal gesetzt, nocheinmal benoetigt 
Label for drive B: 


Directory Passuds Stanp Stamm Stamp 
Label Read Create Access Update 


B:TEITE el off off off off 
Password = NÖNE X NONE beoeutet "kein Fasswaort' ... 
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WICHTIG: 


Paßwort nicht vergessen - sonst kann man Datei oder Diskette 
'vergessen', nur noch sehr intime Kentnisse und geeignete Hilfs- 
programme können dann noch helfen. Es gibt hier allerdings einen 
recht 'hinterhältigen' Trick, falls ein CP/M 2 System zur Verfü- 
gung steht. 


CP/M 2 kennt keine Paßworte, also ist es möglich, alle Dateien 
unter CP/M 2 auf eine frisch formatierte Diskette umzukopieren. 
Der Datenschutz ist dann dahin, alle Datums- und Zeitmarken 
allerdings auch. 


Das Abschalten einer Option hat dieselbe Syntax wie das Ein- 
schalten einer Option, nach dem Zuweisungszeichen '=' folgt je 
doch lediglich ein RETURN (<cr>) oder im Falle von Namen, die 
Zuweisung 'NONE' (=Keiner),. 


+----------- + 
DIR Setzt das DIR-Attribut. Alle Dateien mit 
diesem Attribut werden von DIR erfasst. 
SYS Setzt das SYS-Attribut. Alle Datein mit 


' 
! 

! 

ı diesem Attribut koennen nur von DIRS erfasst 

\ werden. Auf COM-Dateien mit dem SYS-Attribut 

' kann aus allen Benutzer (USER)-Ebenen zuge- 

ı griffen werden. 

I RO Setzt das Rlead)-O(nly) Attribut. Auf Dateien 
! mit diesem Attribut kann nur zum Lesen zuge- 

\ griffen werden. Diese Dateien koennen nicht 

ı veberschrieben werden. 

I RW Setzt das Rlead)-Wirite) Attribut. Dateien 

' mit diesem Attribut koennen gelesen und be- 
ı schrieben werden. 

!  ARCHIVE=ÖN:!OFF Setzt das Archiv-Attribut (ON) oder setzt es 
\ zurueck (ÖFF). Ist dieses Bit OFF, bedeutet 
\ dies, es wurde noch keine Sicherungskopie 

! der enstprechenden Datei gemacht. Dies ist 
! z.B. bei dem Kopierprogramm PIP.COM von Be- 
' deutung wenn Sicherungskopien mit JOKERN ge- |! 
ı 

' 

' 

ı 

L 

! 

' 

' 

' 

L 

ı 

1 

\ 

! 

! 

! 

' 

! 

! 


macht werden. PIP setzt das Archiv-Attibut auf! 

ON, wenn es eine Datei kopiert hat. Die Option! 

ÖFF muss vom Benutzer gesetzt werden! ' 

n=ÖN:ÖFF Die vom Benutzer definierbaren Attribute (1-4)! 
koennen mit dieser Option gesetzt (ON) oder ! 

zurueckgesetzt werden. Diese Optionen sind \ 

z.2. nur fuer den eigenen Gebrauch von ' 

Interesse. ı 

NAME=nnn.xxx Zuweisung des Label nnn.xxx an eine Diskette I! 
PASSWORD=password Zuweisung eines Passwortes (Kennwort) an ! 
eine Diskette. ! 

PROTECT=ON:ÖFF Passwortschutz einschalten (ON) oder aus- ! 
schalten. (ÖFF) Im eingeschalteten Zustand ' 

wird zum Abschalten das Passwort bemvetigt. ! 

ı 

1 

1 


=READ Datei kann ohne Passwort nicht gelesen werden. 
=WRITE Datei kann ohne Password nicht beschrieben 
werden. I 
=DELETE Datei kann ohne Passwort nicht geloescht werden 
=NÖNE Passwortschutz wird zurueckgenommen wenn das |! 


bisheriges Passwort bekannt ist. ı 


——-----— + 








+=--—-—---------___. EEE 


Tabelle 8 Optionen des SET-Attributes 
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+ 
DEFAULT=password Hiermit kann der berechtigte Benutzer sein ' 
Passwort dem Computer mitteilen. Bis zum ! 
Diskettenwechsel oder Abschalten des Systemes ! 

wird anstelle der Passwortabfrage bei jedem ! 

Zugriff nur auf das DEFAULT-Fasswort zuge- ! 

griffen. Dieses Passwort muss natuerlich dem |! 

Zuvor angegebenen Passwort entsprechen. ! 

CREATE=ON:!OFF Alle Dateien erhalten bei der Erstgenerierung ! 
eine Zeit- und Datumsmarke. “Kann nicht mit ! 

ACCESS zusammen definiert werden!) ON=EIN ! 

ACCESS=ON!OFF Alle Dateien erhalten bei jedem Zugriff eine |! 
neue Zeit- und Datumsmarke. (Nicht zusammen ı 

mit CREATE definierbar) ÖN=EIN OFF=AUS ! 

UPDATE=ON!OFF Alle Dateien erhalten nach jeder Aenderung \ 
eine neue Zeit- und Datumsmarke. ON=EIN ı 


noch Tabelle 8 Optionen des SET-Attributes 
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La. 2 22 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2; 


* SETDEF * Der SETDEF-Befehl 
2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 20207 


Syntax: 


SETEr (6, IIIPLLTEMFORARY=I:]) CÖRDER=Ütypt,typ))]) 
SETler [OISPLAYINO DISPLAY] PAGEIND PAGE] 


Beschreibung: 


Mit dem SETDEF-Befehl können bestimmte Vorgabewerte vorbestimmt 
werden, 


Die nachfolgende Beispiele sollen die Anwendung verdeutlichen, 


Eine der wichtigsten Optionen für ein reibungsloses Arbeiten 
unter CP/M 3 ist sicher das Einstellen der Suchfolge auf den 
vorhandenen Laufwerken 


Arsetgef al,k,e! 


Dies bedeutet: eine Datei, gleichgültig auf welchem Laufwerk 
aufgerufen, wird zuerst auf Laufwerk A: gesucht, danach auf dem 
Laufwerk, das im Prompter ( X> ) gezeigt wird. Wird sie auch da 
nicht gefunden, wird in Laufwerk E: nachgesehen, dies könnte z.B. 
eine Harddisk sein. 


welche Suchordnung eingestellt wird, bleibt dem Benutzer über- 
lassen. Es muß lediglich die gewünschte Such-Reihenfolge (bis zu 
drei Laufwerke) eingeben, 


Nach jedem eingegebenen Laufwerksnamen folgt ein Doppelpunkt. 
Soll innerhalb der gewünschten Reihenfolge auf das momentane 
Laufwerk zugegriffen werden so wird dieses mit einem Stern <t> 
bezeichnet, ohne folgendem Doppelpunkt. Unter "momentan' versteht 
man in diesem Zusammenhang das Laufwerk, von welchem aus ein zu 
suchendes Programm aufgerufen wurde, 


Manche Programme legen während des Abarbeitens einer vorgegebenen 
Aufgabe eine oder mehrere Zwischendateien an, die anschließend 

wieder aus dem Inhaltsverzeichnis gelöscht werden. Diese Dateien 
benötigen Platz. der u.U. auf einer vorgegebenen Diskette "eng" 
werden kann. Dem kann mit folgendem Beispiel abgeholfen werden: 


Arsatjaf Itemporaty=ci] 


In diesem Falle werden alle Zwischendateien in Laufwerk C: ab- 
gelegt. 


Eine weitere wesentliche Vereinfachung bei der täglichen Arbeit 
ist die mögliche Zuweisung der Suchordnung von COM- und SUB- 
Dateien, 


Der wirkliche Effekt dabei es weniger, daß je nach Wunsch zuerst 
nach einer SUB- oder zuerst nach einer COM-Datei gesucht wird, 
sondern vielmehr die nicht ausgesprochene Tatsache, daß SUB(mit)- 
Dateien wie COM-Dateien einfach beim Namen aufgerufen werden 
können und nicht, wie noch beim "alten! CP/M 2 mit vorangestell- 
tem SUBMIT, 
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Die Einstellung erfolgt wie folgt: 
Arsetdeflorder=(com,sub)] 


Es wird danach immer zuerst eine COM-Datei mit dem aufgerufenen 
Namen gesucht (und zwar auf allen in der Suchordnung eingebunde- 
nen Laufwerken). Erst wenn eine solche nicht gefunden werden 
kann, wird nach einer SUB-Datei gleichen Namens gesucht. 


Selbstverständlich kann die Suchreihenfolge auch umgekehrt sein. 
Dies bringt Vorteile mit sich, wenn z.B. vor dem eigentlichen 
Aufruf eines Programmes (der COM-Datei) erst noch verschiedene 
Optionen gesetzt werden sollen. Um den Benutzer nicht zu verwir- 
ren, erhält also eine SUBMIT-Datei den "gewohnten' Dateinamen. 
Die SUBMIT-Datei kann nun zuerst seinerseits ein Hilfsprogramm 
aufrufen, welches z.B. verschiedene Optionen im Menü abfragt und 
erst dann die entsprechende COM-Datei; entweder auf einem anderen 
Laufwerk oder passend umbenannt. 


Zwei Optionen ermöglichen es die bei der Systemgenerierung vVor- 
gegebene Optionen zu umgehen: 


Arsetoeflpage] 
Arsetdeflaisplay) 


Im ersten Fall wird z.B. bei TYPE oder DIR nicht mehr am Bild- 
schirmende angehalten, sondern der Text läuft bis zum Textende 
durch. Angehalten werden kann nur noch mit CNTRL-S, weiter gehts 
mit CNTRL-Q. 


Im zweiten Falle werden vor jeder Programmausführung noch die 
sogenannten Systemparameter (falls vorhanden) mit auf dem Bild- 
schirm ausgegeben. Darunter sind Angaben wie gültige Laufwerks- 
nummern, Dateiname und Dateityp sowie die eingeschaltete USER- 
Nummer zu verstehen. 


Beide Optionen können mit einem vorangestellten 'no' wieder 
abgeschaltet werden. 
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WE a he 


%* SHOW * Der SHOW-Befehl 
rc a" 


Syntax: 
SH (AS) CLSFLE LABEL ILSERS:DIR:ORILVE))) 
Beschreibung: 


SHOW hat unter CP/M 3 etwa die gleiche Funktion wie STAT.COM 
unter CP/M 2. 


Mit dem SHOW-Befehl und seinen Optionen kann der Benutzer Infor- 
mationen über Restspeichergröße der Disketten, Laufwerkscharak- 
teristiken, Diskettenname und die restliche Kapazität des In- 
haltsverzeichnis erhalten, 


Die folgenden Beispiele zeigen die Anwendung und das Ergebnis: 


Arshaw < ohne weitere Angaben .. 

A: FW, Spare! 25. < zeigt Restkapazitaet aller 

Ei RW, Space: IK < eıngelaagten Lautwerke 

A,show bi [label] < Frage nach oem Label (Namen) 

Label for drive Bi < wird nit allen Einzeineiten beantwortet 


Directory Passwis Stanp Stamp 
Label Regd Create Update Label Created Label Updated 








TEXTE ul oft on on /24/85 89:19 12/28/85 13:20 

}show [users] < die Frage nach den (benutzten) USER-Ebenen 
A: Actıve ser ! 9 X @=keine USER-Ebene benutzt 

A! Actıve Fils: 9 < ... dann natuerlich auch keine Dateien 

A: kar fıls ! 13 < dies sınd dıe Dateien in USER-# oder SYS 
A: Number nf tıme/date directory entries: 64 < belegt von Zeitmarken 

A: Number of frae dırectary entries! 167  < freıe Eintrage 


Arsnaw [air] < hier wird nur nach den Eintraegen gefragt 


A: Number of time/date dırectory entries: 64 
A: Number of free Jırectory entries: 167 
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Adshow Ldrive) < hier wird nach der Dishettenspezifikation 
< getragt ... 


A: Drive Characteristics < Charakteristik fuer Laufwerk A: 
9,6: 128 Byte Record Capacıty < Anzahl der Ülegıchen) Sektoren 
1,26%: Kilobyte Drive Capacıty < ges..Laufwerkskapazıtaet (ın K) 

256: 32 Eyte Directory Entries Anzahl cer Dik-Eintraege 
256: Checked Directory Entries < soviele werden geprueft 
128: Records / Directory Entry < (log) Sektoren pro Eintrag 


16: Records / Block < (log) Sektoren pro Eiork 
128; Sectors / Track < (log) Sektoren pro Track (Zylinaer) 
2: Reserved Tracks < reservierte Tracks 


1,624: Bytes / Pnysical Record X (phys) Sektargroesse 


Anmerkung: 


Unter logischen Sektoren versteht man die kleinste physikalisch 
mögliche Sektorgrösse von 128 Bytes. Diese Grössenangabe rührt 
sicherlich auch heute noch aus den "alten! CP/M-Zeiten her, als 
nur diese Größe vom BDOS verarbeitet werden konnte. Heute kann 
das BDOS Sektorgrößen bis 1024 Bytes (1k) selbst verwalten. 


Unter Eintrag versteht man die Anzahl von Blöcken, die in einem 
DIR-Eintrag verwaltet werden können. Große Dateien benötigen 
demzufolge mehrere DIR-Einträge, obwohl jeder Eintrag im In- 
haltsverzeichnis nur einmal erscheint. 


Dies klärt auch den scheinbaren Widerspruch in obigem Beispiel, 
daß (unter USERS zu erkennen) nur 13 Dateien vorhanden sind, aber 
diese 25 DIR-Einträge belegen. 


(Zum Nachrechnen: 256-(64+167) =25) 


Unter Block versteht man die Mindestgröße eines einzelnen DIR- 
Eintrages. Er ist bei Standard-CP/M-Disketten oder bei Disketten 
mit weniger als 256k Speicherplatz üblicherweise Ik groß. Bei 
allen anderen Disketten ist die Blockgröße meist 2k (16*128Byte 
im Beispiel). 


Das wichtigste Kriterium bei der Blockgröße (sie wird im BIOS be- 
stimmt!) ist es, daß ihre Größe multipliziert mit der Anzahl der 
DIR-Einträge die maximal mögliche, belegbare Speichergröße einer 
Diskette bestimmt. Eine Harddisk mit 64MB Speicherkapazität nützt 
nichts, wenn dafür nur 128 DIR-Einträge bei 2k Blockgröße vorge- 
sehen werden. (Dies würde maximal 4MB und minimal 256k möglicher 
Belegung zulassen — danach würde das System lakonisch DIRECTORY 
FULL melden) 
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LE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 22 25 


* SUBMIT = Der SUBMIT-Befehl 
WERE AR 


Syntax: 
SEMIT (filename) (argument]) ... Cargument]#, 
Beschreibung: 


SUBMIT gehört eigentlich mehr zu den in Kapitel 5 besprochenen 
Programmen und Werkzeugen. Unter CP/M 3 ist es (siehe hierzu 
SETDEF) jedoch möglich, eine SUB(mit) Datei durch einfachen Auf- 
ruf wie einen Befehl ablaufen lassen zu können. 


Es kommt bei der Programmentwicklung recht häufig vor, daß bis 
zum endgültigen Ergebnis viele Einzelbefehle an den CCP gegeben 
werden müssen. Teilweise sind diese Befehle darüberhinaus lang 
und kompliziert, dazu hin muß der Programmierer "am Gerät' blei- 
ben, auch wenn manche Sequenzen lange dauern. 


Hier greift der SUBMIT-Befehl ein. Mit einem Editor werden alle 
Befehle in einzelne Zeilen geschrieben und dann nur noch diese 
Datei aufgerufen. Diese Datei MUSS den Index SUB haben, damit 
SUBMIT sie erkennt. 


Es können auch Parameter in der Befehlszeile übergeben werden. Es 
sind bis zu zehn Parameter zuläßig, jedem Parameter ist ein 5 
gefolgt von einer Zahl 1..10 voranzustellen. 


Werden Programme wie PIP oder SUB aufgerufen, die einen gewissen 
Dialog verlangen, so können die dort erwarteten Eingaben mit 
einem vorangestellten '<' bereits in der SUB-Datei eingegeben 
werden. Ein '<' ohne nachfolgendem Befehl entspricht einem RETURN 
[tl > 


Empfängt SUBMIT noch Daten, nachdem dies eigentlich nicht mehr 
erwartet wird, wird die Warnung 


Warnıng: Program input ignored 


ausgegeben, bevor das Programm abgebrochen wird oder ein weiterer 
SUBMIT-Lauf erfolgt. Fehlen dagegen Daten, die von der SUB-Datei 
nicht mehr geliefert werden, wird auf eine Eingabe über die 
Tastatur gewartet, 


Die SUB(mit)-Datei PROFILE.SUB ist in diesem Zusammenhang von 
ganz besonderer Bedeutung. Nach jedem Kaltstart (Boot) prüft der 
CCP nach, ob auf der Boot-Diskette diese Datei vorhanden ist. 
Wenn dies der Fall ist, wird sie automatisch über SUBMIT aufge- 
rufen. Mit dieser Datei können nun nach jedem Kaltstart beliebige 
Systemparameter gesetzt werden und, falls dies gewünscht wird, am 
Ende noch der automatische Start eines beliebigen Programmes 
veranlaßt werden. 


Ein SUBMIT-Lauf bedeutet immer die Ablage eines Zwischenpro- 
grammes auf der jeweiligen Diskette. Aus diesem Grund darf die 
Diskette nicht schreibgeschützt sein. Im Falle von PROFILE. SUB 
muß natürlich auch die Datei SUBMIT.COM auf der Boot-Diskette 
sein. Ist eines von Beidem nicht der Fall, wird PROFILE.SUB 
schlichtweg ignoriert, das System bootet ohne der gewünschten 
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Voreinstellung von Optionen --- und das ohne jede Warnung I!lllll 


Eine übliche PROFILE-Datei zeigt das folgende Beispiel, in wel- 
chem zuerst die Suchordnung der Laufwerke und Programme vorgege- 
ben und danach die Eingabe des Datums und der Uhrzeit erzwungen 
wird. 


SETLEF X, A: TORDER=(COM, SUR) 
DATE SET 


Ein kleines Spiel-Beispiel zeigt noch die Anwendung der Para- 
meterübergabe in einer SUBMIT-Datei. Im Beispiel werden die 
Quellbeginn- und Endadresse sowie die Zieladresse eines move- 
Befehles an SID übergeben. 


sıd 

<t100,12,55 

ea Erf AA 
ala, If 

shirt 

«"oies ist ein test” 
°. 

(ms1,92,93 

<olöus, I1f 
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(P/m 3 SID - Version 3.6 
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KiEoan ‚Eeif,AA 
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Kapitel 5 Werkzeuge und Programme von CP/M 3 


Digital Reseach hat seinem CP/M 3 eine ganze Reihe hervorragende 
Werkzeuge (Utilities) und Programme beigefügt. Sie sind fast 
ausschließlich für den erfahrenen Programmierer gedacht, und 
sollen es diesem ermöglichen, sich Hardware-Anpassungen an CP/M 3 
nach eigenen Wünschen zu schreiben und diese Programmteile zu 
einem maßgeschneiderten System zusammenzubinden. 


Mit diesen Werkzeugen können selbstverständlich auch eigenstän- 
dige Programme entwickelt und "entwanzt' werden. 


Leider bietet Digital Research unter CP/M 3 keinen Debugger mit 
280 Mnemonics, aber der 'alte' ZSID ist ohne weiteres funktions- 
fähig, geeigneter ist vielleicht noch das Public-Domaine Programm 
DDTZ, da es eine SAVE-Funktion zur Verfügung stellt, die ZSID 
nicht hat. 


Auch die an sich recht guten Assembler sind voll auf die INTEL- 
(8080)-Mnemonics ausgelegt. Es können damit zwar mit Hilfe einer 
MACRO-Bibliothek, die mitgeliefert wird, auch Z80-Programme ge- 
schrieben werden, aber eben nicht mit Zilog(Z80)-Mnemonics son- 
dern einem Kauderwelsch von 8080 und 280. Der Z80-Benutzer wird 
daher nicht umhin können, einen guten Z80-Assembler zusätzlich zu 
erwerben. 


Ein weiteres 'Problem' ist der von Digital Research mitgelieferte 
Editor ED.COM. Es handelt sich hierbei um einen zeilenorientier- 
ten Editor, d.h. es kann immer nur innerhalb einer Zeile korri- 
giert (editiert) werden und nicht wie heute gewohnt, durch ein- 
fache CURSOR-Bewegungen über den ganzen Bildschirm hinweg. 


Der Vorteil von ED liegt eigentlich allein darin, daß gleichgül- 
tig wie "exotisch' die angeschlossene Konsole auch angesteuert 
werden muß. mit ED kann immer gearbeitet, da nur die Steuer- 
funktionen CR und LF benötigt werden (die genormt sind). Im 
Übrigen wird nur der Standard-ASCII-Zeichensatz benötigt. 


Es würde den Rahmen dieser Zusammenstellung bei weitem sprengen 
wenn der Umgang mit den nachfolgend besprochenen Programmen de- 
tailliert ausgeführt würde. In diesem Kapitel sollen lediglich 
die Aufrufkonventionen und die entsprechenden Steuerbefehle zu- 
sammengestellt werden. Die entsprechenden Handbücher von DIGITAL 
RESEARCH geben genauere Auskünfte, 


Das Arbeiten mit dem Programm GENCPM.COM wird in Band I (Hard- 
ware-Anpassung) ausführlich besprochen. 
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EI EI I 2 2 2 2 2 2 2 2 2 2 2 2.2: 


* ED « der Editor 
Wr 


Syntax: 
ED (d:} (gateinane.ext) 


Beschreibung: 


ED ist ein zeilenorientierter Editor,geeignet für relativ ein- 
fache Textverarbeitung, vor allem aber gedacht zum Schreiben von 
(Assembler-) Programmen zur Systemanpassung. 


ED kann bereits mit dem zu bearbeitenden Dateinamen aufgerufen 
werden oder falls dies nicht der Fall ist, fragt ED nach weiteren 
Informationen wie das folgende Beispiel zeigt: 


Enter Input File: test.txt 
Enter Qutput File: 

NEW FILE 

x 


Unter Inputfile ist der Name zu verstehen, unter welchem die 
Datei auf der Diskette abgelegt wurde oder der Name einer neu zu 
eröffnenden Datei. 


Wird eine bereits vorhandene Datei aufgerufen, so kann diese 
unter einem anderen Namen abgelegt werden, wenn die zweite Frage 
(Output File) entsprechend beantwortet wird. 


Die zweite Frage kann auch allein oder zusätzlich mit einer Lauf- 
werksbezeichnung (gefolgt von einem Doppelpunkt) beantwortet 
werden. In diesem Falle wird die Datei nach erfolgter Bearbeitung 
auf der Diskette in dem genannten Laufwerk abgelegt. Wird die 
Frage nur mit <cr> beantwortet, wird die einzulesende Datei in 
filename.BAK umbenannt und die neu abzulegende Datei erhält den 
"alten' Dateinamen. 


Nach diesen 'Vorbereitungen' meldet sich ED mit seinem Befehls- 
prompter '*'. Mit den in Tabelle 9 genannten Befehlen kann nun 
ein beliebiger Text editiert werden. 


Zum '"Start' soviel: 


In den Schreibmodus kommt man mit dem I(nsert)-Befehl. Wurde eine 
Datei benannt, die bereits vorhanden ist, muß diese erst mit dem 
A(ppend)-Befehl in den Editier (Schreib) -Puffer geladen werden. 


Ein recht umfangreicher Befehlssatz macht es dann möglich, die 
'Eintritts'-Stelle zu suchen und dort im dem I-Befehl in den Text 
hineinzukommen oder mit entsprechenden anderen Befehlen sonstwie 
zu editieren. 


61 








+4 
I Befehl 
+ 

ı nA 

l 

N oA 

ı 

ı 

ı #A 

ı 

ı 

ı 

ıB, -B 

ı 

ı 

I! nC,-nC 
f 

! nd, -nDd 
ı 

ı E 

j 

I Ftext"Z 
IH 

ı 

IH 

ı 

ı 

ı 

ı 

ı 

I nk, nk 
ı 

I! nL,-nL 
U nMbefehl 
In,-n 

1 

In! 

! n:befehl 
ı 

I Ntext”Z 
ı 
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Auswirkung 


fügt n Zeilen aus der aufgerufenen 


Datei an den Speicherpuffer an (Append). 


fügt soviele Zeilen aus der aufgeru- 
fenen Datei an den Speicherpuffer an, 
bis dieser halb voll ist. 

fügt soviele Zeilen aus der aufgeru- 
fenen Datei an den Speicherpuffer an, 
bis dieser voll oder die Datei zu 


Ende ist. 


setzt den Zeilenzeiger auf den Beginn 
oder das Ende (-B) des Textes im 
Speicherpuffer (Beginn). 

setzt den Zeilenzeiger n Zeichen vor- 
wärts oder rückwärts (-nC) (Columne). 
löscht n Zeichen nach (nD) oder vor 
(-nD) dem aktuellen Zeichen (Delete). 
legt die editierte Datei ab und kehrt 
zum CCP zurück (Exit). 

finde 'text’ ab Zeilenposition (Find). 
Zwischenspeichern der editierten Datei 
ohne den Editor zu verlassen (Hold). 
Start des Einfuegungsmodus (Insert). Es 
können nach I beliebige Zeichen einge- 
fügt werden. Aussprung aus dem I-Modus 
mit CNTRL-Z oder ESC-ape. 

ACHTUNG: Groß-I fügt nur Großbuch- 
staben ein, Klein-i beides. 

löschen von n Zeichen vor (-n) oder 

ab der aktuellen Position. (Kill) 

n Zeilen vor oder (-n) zurück. (Line) 
den Befehl <befehl> n-mal ausführen. 

n Zeilen vor oder zurück (-n) und diese 
Zeile ausgeben. (Make) 

Zeiger auf Zeile n stellen. 

führe Befehl <befehl> zeilenweise bis 
Zeile n aus. 

suche den Text <text> über den ganzen 
Speicherpufferbereich (Next). 


Tabelle 9 


Zusammenfassung der ED-Befehle 


=. 





REES SOU OESUESEEN a 
ı Befehl Auswirkung ! 
+--------- --- + 
ro mache alle Änderungen seit Beginn der ! 
l Editierphase rückgangig. (Original) ı 
I nP,-nP es werden die nächsten (n) Zeilen aus- |! 
! gegeben oder die letzten (-n) Zeilen. ! 
ı (Frint) ' 
ı Q Abbrechen der momentanen Editerarbeit ! 
ı ohne Abspeichern der Datei (Quit). ı 
ı Rfilename.ext”2 Datei filename.ext in den Datenpuffer ' 
ı lesen. A-Befehl zum ’anhängen’ be- ! 
1 nutzen ! (Read) ! 
I Stextl"Ztext2’Z löschen von text] dafür einfügen \ 
! von text2 (Substitute). ' 
I nT,-nT Ausgeben von n Zeilen Text (Type). ! 
ı UV Textumwandlung von Kleinbuchstaben in ' 
ı Grofbuchstaben. (Uppercase) \ 
I V,-V Zeilennummerierung AN/AB-Schalten. ' 
ı 00 Ausgabe des restlichen Speicherplatzes. ! 
I nW Ausgabe von n Zeilen auf Diskette an \ 
! bearbeitete Datei (Write). ' 
I nXfilename ..ext”Z Ausgabe von n Zeilen an die Datei ' 
! <filename.ext>. Die Zeilen werden an ! 
! eine evtl vorhandene Datei angehängt. ! 
ı @Xfilename.ext”Z lösche Datei <filename.ext>. ' 
4--—— + 


noch Tabelle 9 Zusammenfassung der ED-Befehle 
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frei für Notizen zum "eigenen! Editor 
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La 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 202 


* LIB « der LIBrary-manager 
a2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 207 


Syntax: 


LIß filenamet[1:!M:P:0]) 
Li filenanet[1!M:P))=filenanetmoaıfier){,fılenanetmoaıfier)...) 


Beschreibung: 


Mit LIB werden sogenannte library-Dateien (Programm-Bibliotheken) 
zusammengebunden. 


Es handelt sich dabei um (REL)-Dateien immer wieder benutzter 
Unterprogramme, die mit LINK zu ablauffähigen Programmen zu- 
sammengebunden werden. Entsprechende REL-Dateien werden von RMAC 
erzeugt aber auch von anderen Assemblern wie M80 oder ZBOASM. 


In jedem Falle wird das sog. Microsoft (R)-REL-Format verwendet. 
LIB-Dateien sind vor allem für den geübten Assemblerprogrammierer 
von Nutzen aber auch dem Programmierer von Hochsprachen wie PLI1 
oder FORTAN, die derartige LIB-Dateien in ihre Programme einbin- 
den können. 


Es stehen folgende Optionen zur Verfügung: 


I es wird eine indizierte Datei ....IRL generiert, auf 
die LINK schneller zugreifen kann. 


M Modul-Option, die Namen der einzelnen Module werden 
hier auf den Bildschirm ausgegeben 


P Die Public-Option schließt die M-Option ein und gibt 
darüberhinaus noch die Namen aller public-Variablen 
an. 


D Diese Option gibt den Inhalt der Module in ASCII aus. 


Zur Erweiterung, Veränderung und Auswahl von Modulen stehen fol- 
gende "modifier' (siehe Syntax) zur Verfügung: 


delete <module=> 


replace <module=filename.REL> oder <filename> wenn 
Modulname und 'filename' gleich sind. 


select (anfangsmodul-endmodul,modl,mod2,...modn) 
Dies sei durch nachfolgende Beispiele verdeutlicht: 
ALIE test[pl=test],test2,test4,test5,test6 


Hier wird eine neue LIB-Datei TEST.REL erzeugt, welche die 
Dateien testl.REL bis test6.REL enthält. Alle Modulnamen (TESTl 
bis TEST6) werden auf den Bildschirm ausgegeben, darüberhinaus 
noch alle public-Namen (d.h. die Labels der eingebunden Unter- 
programme). Der Sinn dieser Ausgabe ist es, festzustellen (und 
evtl. mit dem Drucker zu protokollieren) welche Programnteile 
eine LIB-Datei enthält. 
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ALIB nylibztest(test],test3),console(auxın-Istaut, clock) 


Hier wird die LIB-Datei MYLIB.REL aus der LIB-Datei TEST.REL 
generiert. Die neue Datei enthält jedoch nur die Module testl und 
test3. Darüberhinaus wird die LIB-Datei CONSOLE.REL eingebunden 
jedoch nur mit den Programmteilen AUXIN ... LSTOUT und CLOCK. 
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wre" 


* LINK “ der Linker 
wre ha 


Syntax: 


LINK (di) filenane){Loption))=filenanel(lo)lt,........ 
Beschreibung: 


Mit LINK.COM werden REL(ative)-Dateien zu einem ablauffähigen 
COM-Programm ge'linkt' (gebunden). 


LINK ermöglicht es, zumindest während der Entwicklungsphase, 
Programme in kleine Module aufzuspalten, die wesentlich einfacher 
zu bearbeiten und zu 'debuggen' sind. Die einzelnen Module werden 
dann erst am Schluß, wenn alles fehlerfrei ist, zu einem Programm 
zusammengebunden (gelinkt). 


Wird genau genug definiert, was jedes Modul 'können'!' soll, so ist 
es auch absolut möglich, daß die Programmentwicklung von mehreren 
Programmieren einzeln geschehen kann. 


REL(ative)-Programme, sind Programmsegmente, die keine absoluten 
Adressangaben enthalten, vielmehr werden alle Adressen erst beim 
Linken definiert. (Alle Adressen sind RELativ zu einer noch zu 
definierenden Startadresse). 


Ein typisches Beispiel des Linkens zeigt das Zusammenbinden des 
BIOS-Teiles von CP/M 3, das seinerseits aus mehreren Modulen 
besteht: 


Arlink bnkbios?lbl=sch,bıoskrnl,charıo,rove,cıskıo,bant 
LINK 1.31 


eRIVEC FEZE @AQVEC FEZE @krL6b FEST KENNER FESS 
WIVEC  FE2Z @IüVe Fezd MÜROMA FE BCRUSK Fox 
KAT FESE Mehuge FESI Menmoe FEdE rk FE&: 
OR FESA MLOVEc FEZA MEDIA FESE @nin  FEbE 
eMTIO FEAR EMKTPA FEED EhtStl FE SEC FESC 
EUSRCO  FEAL WINFO FEF 3 MEN iA NT bikk 
KT 7 eK A m uk ei 
EOTEL hdib MSECT MER MiRk  MIE2 DSKSTA Geb] 
GETADR el GETDPR @rSl IPCHL GES MÜTOFF Ed 
SNOSTL A2AA TABLEI G17B CIKGET E63 CLKSET 6625 
DSKNAM  M2CC IZCINI MrSl CURDPH 14tE 


ABSOLUTE 6060 
CODE SIZE AED (eie-aAGL) 
DATA SIZE 6OFD (EBRd-1BFC) 
Common SIZE en 
USE FACTOR 


Im Beispiel wird eine Datei BNKBIOS3.SPR generiert. Alle als 
"public" oder Global definierten Adressen werden ausgegeben. 
Unter Globalen Adressen versteht man Labels (Unterprogramm-Mar- 
ken), die in einem Modul als Programm vorhanden sind, in einem 
anderen Modul aber aufgerufen werden. 
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Zur Definition stehen verschiedene Assembler-Anweisungen zur 
Nach den Label-Angaben mit den zugehörigen Adressen 


Verfügung. 


folgen Angaben über das gebundene Programm: 


ABSOLUT 


CODE SIZE 


DATA SIZE 


COMMON 


das heißt unveränderlich sind 0000 Programmseg- 
mente. 


in diesem Fall der Anteil an Programmsegmenten im 
gemeinsamen Speicherbereich sind O0A6DH Bytes, 
beginnend bei der (immer noch relativen ) Adresse 
00004. 


in diesem Falle der Anteil im gebankten Speicher- 


bereich sind ODFDH Bytes, beginnend bei Adresse 
OBOOH. 


ist bei der benutzten Definition nicht vorgesehen. 


Der USE FACTOR gibt an wieviel Prozent des vorhandenen Speicher- 
platzes während des Linkens benutzt wurde. 


Dnnnn 
Glabel 


Innnn 


z 
Fr 
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Zwischendateien werden auf Diskette angelegt, \ 
notwendig wenn der Speicherplatz im Arbeits- ' 
speicher zu klein wird. ! 
generiert eine SPR-Datei.(notwendig z.B. zum ! 
generieren von CFPM3.5YS) ! 
Beginn des Datensegmentes ab Adresse nnnn (Hex). | 
Startadresse des Programmes wenn dieser nicht am |! 
Programmanfang. Es wird von LINK dann eine zu- ' 
sätzliche Programmzeile (JP label = vielmehr ' 
C3 labeladresse) generiert. ' 
Startadresse des Programmes (Vorgabe ist 1®6H). ' 
Diese Adresse ist genauergenommen die Adresse des ! 
ersten Programmbytes. Im Unterschied hierzu geben |! 
die Adressen Pnnn und Dnnnn nur den Beginn eines |! 
entsprechenden Segmentes an. ! 
Unterdrückt Ausgabe der SYM(bol)-Tabelle. ! 
legt keine SYM(bol)-Datei an. ! 
Beginn des Programmsegmentes (Vorgabe ist 1064). |! 
Alle Symbole die mit ? beginnen werden ausgegeben. ! 
vorangestelle Datei ist als LIB-Datei zu behandeln! 
Konsolenausgaben werden auf Ausgabeeinheit ’d’ um-! 
gelenkt. Möglich ist außer den Laufwerksbe- ' 
zeichnungen A..P noch zusätzlich Y=LST (Ausgabe ! 
auf den Drucker), X=CÖNOUT (Ausgabe auf die Kon- |! 
sole) und Z=NULL (keine Ausgabe). Vorgegaben ist X! 
evtl. notwendige Zwischendateien werden auf Lauf- ! 
werk ’d’ ausgegeben. Vorgabe ist das Laufwerk von ! 
dem aus LINK aufgerufen wurde. ' 
Zieladresse der COM-Datei. ’d’ kann Laufwerk A-P |! 
sein oder Z=NULL (siehe hierzu die $I-Option). ' 
Zieladresse der Symboltabelle (SYM-Datei). ' 
’d’ kann Laufwerk A..P sein oder Z=NULL ' 


Tabelle 10 Optionen von LINK.COM 
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* (R)MAC * die macro-Assembler 
wre a a ha 


Syntax: 


MAC filenane ($options) 
RMAC fılenane ($ra:$sdi$pd) 


Beschreibung: 


Assembler dienen dazu aus sogenannten Assemblerprogrammen (Quell- 
Programmen), die in verhältnismäßig einfach zu merkenden Mnemo- 
nics (Kürzel von Programmieranweisungen) geschrieben sind, einen 
code zu erzeugen, den die entsprechende CPU direkt verstehen und 
abarbeiten kann. 


Bei Assemblerprogrammen wird im Gegensatz zu Hochsprachenpro- 
grammen jedes Register und jedes Flag der CPU direkt angespro- 
chen. Assemblerprogramme sind meist schlechter zu "durchschauen’ 
und wesentlich aufwendiger zu schreiben als Hochsprachen-Prog- 
ramme, haben dafür jedoch den durch nichts zu ersetzenden Vorteil 
kompakt und schnell zu sein. Keine Hochsprache ist (zumindest 
bisher) in der Lage auch nur eine dieser Bedingungen zu erfüllen. 


Es kann in diesem Zusammenhang auf die vielfältigen Möglichkeiten 
der Assemblerprogrammierung nicht eingegangen werden. Beispiel 
sind jedoch im Anhang zu finden, gute Fachbücher zu diesem Thema 
darüberhinaus leicht erhältlich. 


Der Unterschied zwischen MAC.COM und RMAC.COM liegt allein in der 
Tatsache, daß nur RMAC.COM sogenannte REL-Dateien erzeugen kann, 
während MAC nur die macro-Version des '"alten' (CP/M 2) ASM.COM 
ist. Die Optionen beider Assembler sind in Tabelle ll zusammenge- 
faßt. 


MAC und RMAC erwarten eine Eingabedatei mit dem Index file- 
name.ASM. Als Ausgabedateien können die Dateien filename.PRN und 
filename.SYM erstellt werden, wobei die PRN-Datei das sogenannte 
Listing, d.h. das komplette Programm mit allen Adressangaben und 
dem Befehlscode in HEX enthält, während die SYM-Datei die u.U. 
für (Z)SID benötigten Labeladressen enthält. Von MAC.COM wird 
darüberhinaus noch eine Datei filename.HEX während RMAC.COM die 
Datei filename.REL generiert. 


Die beiden zuletzt genannten Dateien sind Vorstufen der eigent- 
lichen Programme. HEX-Dateien werden mit HEXCOM in COM-Dateien 
umgewandelt oder mit (Z)SID und anderen HEX-Dateien zu einem 
Gesamtprogramm zusammengebunden, während REL-Dateien mit LINK in 
COM-Dateien gewandelt werden. Nachfolgend Beispiel der Aufruf- 
konventionen: 


Armac change 

CP/M MACRO ASSEM 2.0 
adbd 
66H LSE FACTOR 

END OF ASSEMELY 


Adrmac change 

CP/M RMAC ASSEN 1.1 
6464 
Bun USE FACTOR 
END OF ASSEMBLY 
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Ad Laufwerk auf welchem sich die ASM-Datei befindet 
möglich ist Laufwerk A..O. 

Hd Laufwerk auf welchem die HEX-Datei abgelegt wird, 
möglich ist Laufwerk A..O und Z=keine Ausgabe. 

Ld Laufwerk auf welchem sich LIB-Dateien (Aufgerufen 
von MACLIB-Befehlen) befinden. 

Pd Laufwerk auf welchem die PRN-Datei abgelegt wird, 


Möglich ist Laufwerk A..O, Z=keine Ausgabe, 
P=LST und X=CONÖUT. 

Sd Laufwerk auf welchem die SYM-Datei abgelegt wird, 
möglich ist Laufwerk A..O, Z=keine Ausgabe, 
P=LST und X=CONOUT. 


Für RMAC sind nur die Optionen Pd und SJ gültig, anstelle von 
Hd tritt Rd als Ziellaufwerk auf welchem die REL-Datei ab- 
gelegt wird. 





Werden keine Optionen angegeben, so ist immer das Laufwerk 
von welchem aus das Programm aufgerufen wurde das Quell- 
und Ziel-Laufwerk. 


Nur für MAC - zusätzliche Optionen! 


nn nn nn en nn m nn nn nn m hm m en m m m m en a a hm m re 


+ Eingabezeilen aus MACRÖ-Buecherei werden aufge- 
listet. 

=; Eingabezeilen aus MACRO’s werden unterdrückt. 
( dies ist die Vorgabe ) 

+M Alle MACRÖ’s werden aufgelistet wie sie während 
des Assemblerdurchlaufes auftreten. 

-M MACRO’s werden nicht aufgelistet (Vorgabe). 

+Q Alle (Macro-)LÖCALS werden in die SYM-Liste 
übernommen. 

-Q LOCALS werden nicht in die SYM-Liste übernommen 
(Vorgabe). 

+5d SYM(bol)-Tabelle wird an PRN-Listing angehängt 
mit Ziellaufwerk (siehe oben). 

-5 Es wird keine SYM(bol)-Tabelle generiert. 


Tabelle 11 Optionen der Assembler MAC und RMAC 
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LES 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2.2; 


* PIP * Das Kopierprogramm 
a2 2 2 2 2 2 2 2 2 2 2 2 2 2 2.2 20202 


Syntax: 


PIF zielname:d: ([&n])=quellname.ext([Optionen]{,..):d:[Löptıonen)) 
Beschreibung: 


PIP (Peripheral Interchange Programm) ermöglicht es, Kopien von 
einer oder mehreren Dateien von dem einem auf das andere Laufwerk 
oder von der einen auf die andere USER-Ebene zu kopieren. Die 
Dateien können dabei umbenannt, aneinandergehängt oder nur teil- 
weise kopiert werden. Sie können in Groß- oder Kleinbuchstaben 
gewandelt oder mit Zeilennummern versehen werden, wenn es sich um 
Textdateien handelt. Kopierziel kann neben einem Laufwerk auch 
eine andere logische Einheit wie z.B. ein Drucker oder der AUX- 
Kanal sein. 


PIP kopiert alle Systemattribute und fragt bei Kennwort-geschütz- 
ten Dateien nach dem Paßwort. 


l. Kopieren von Dateien. 


Es können Dateien einzeln oder mit Joker zum Kopieren aufgerufen 
werden. 


Als erste Angabe muß das Kopierziel angegeben werden (gefolgt von 
einem Doppelpunkt), danach folgt der Name unter welchem die zu 
kopierende Datei im Kopierziel abgelegt werden soll. Bleibt der 
Name der gleiche, kann er bei der Eingabe entfallen. Die Angabe 
der Kopierquelle folgt als nächstes, getrennt durch ein vorange- 
stelles '='-Zeichen. Ist die Kopierquelle das Laufwerk, von wel- 
chem aus PIP aufgerufen wurde, kann eine entsprechende Angabe 
entfallen. Als letztes folgt der Name der zu kopierenden Datei, 
der Joker enthalten darf. (*.* bedeutet dann ALLES kopieren). 


Es sind dann nur noch einige Optionen möglich, vom Dateinamen 
getrennt durch eckige Klammern. 


Die nachfolgenden Beispiele sollen dies verdeutlichen, alle Op- 
tionen sind in Tabelle 12 zusammengefaßt. 


AMpip bi=test.com 

Mpip b:=t.t 

Apıp bi=4.tLvor] 

MPpip binyfile.asml61]sa:lib.macll] 
Apip Aizb:t.rac 


2. Zusammenfassen von Dateien 


Mit PIP kann (auf dem gleichen Laufwerk) auch eine Datei so 
kopiert werden, daß eine zweite Datei mit anderem Dateinamen 
entsteht. 


Diese Möglichkeit ist dann von Nutzen, wenn eine vorhandene 
Datei unverändert bestehen bleiben, sie andererseits aber als 
"Grundstock' für ein neues Programm dienen soll. In diesem Falle 
nn. es auch möglich, aus mehreren Dateien eine neue Datei zu ge- 
nerieren. 


7ı 


Als Zieldatei kann natürlich in diesem Falle auch ein anderes 
Laufwerk dienen, 


Werden als Quelldatei mehrere Dateien (durch Komma getrennt) 
angegeben, so bedeutet dies immer, daß die angegebenen Dateien in 
EINER Zieldatei zusammengefaßt werden. 


Diese Möglichkeit der Programm'vervielfachung' ist heute weniger 
gefragt, sie kann mit modernen Editoren einfacher und über- 
sichtlicher geschehen, 


A>PIP newfile.nacznewf ıle.asm 
APIP nevfilesfilel,fıle2,file3 
A>PIP bitest.baszmaster bas,b:fınal.bas 


3. Kopieren von oder nach logischen Einheiten. 


Dieser Sonderfall des Kopierens erlaubt das Ausgeben oder Ein- 
lesen von Dateien auf bzw von den logischen Einheiten AUX, CON 
und LST. 


Die zugelassenen Ziel- bzw Quell-Einheiten zeigt folgende Auf- 
stellung: 


als Ziel als Quelle 
ud: Auksilo)) AuX-Eingabe oder Ausganekanal 
CEN: Con: {lol} Konsolen Eingabe ter Ausgabekanal 
FAN: Druckerausgabe jedoch mıt TAB- 
Expansion und Seitenvorschub nach 
64 Zeile 
LST: Druckerausgabe 
MUL! Eine (iaagınaere)ellsater are 
49 mal O0H ausaıbt 
EOF! Eine (imagınaere) (velldateı gie 
Ix CNTRL-2 (1AH), ausgıbt. Diese 
Zeichen ist dıe (Text Endemarkierung 


Die folgendenden Beispiele zeigen einige Anwendungen: 


Im ersten Falle wird zuerst jede Konsoleneingabe, d.h. alles was 
über die Tastatur eingegeben wird, auf den Drucker ausgegeben. 
Nach Eingabe eines CNTRL-Z werden hintereinander die Dateien 
myfile und yourfile auf den Drucker ausgegeben. 


Im zweiten Falle wird jegliche Tastatureingabe (die ja auf CON 
wiedergegeben wird) in einer Datei reserve,all abgespeichert. 


Beendet wird dies durch ein CNTRL-Z. 


A:pıp prni=con: ‚ayfile,yourfile 
Arpip bireserve.all=CüNn: 


PIP kann auch ohne jede weitere Angabe aufgerufen werden. Es 
meldet sich dann zuerst mit Namen und dann mit einem Stern '#' 
als Prompter. 


Es kann nun wie zuvor gezeigt gearbeitet werden. Der Nutzen liegt 
hier darin, daß PIP nicht mit jedem Aufruf neu von Diskette 
geladen werden muß, sondern alle weiteren Befehle aus dem Ar- 
beitsspeicher heraus bearbeitet. 
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Muß PIP Dateien kopieren, die größer als der freie Arbeits- 
speicher sind, so wird die Kopierarbeit in mehreren Schritten 
erledigt. 


Wird PIP mit den Optionen U oder L belegt (die sich natürlich 
gegenseitig ausschließen) kann bei größeren Dateien schon einmal 
eine "'Ruhepause' eintreten, die bis zu einer Minute betragen 
kann. In jedem Fall meldet sich PIP mit dem CCP-Prompter oder bei 
Direktaufruf mit dem *-Prompter zurück. 


MPIP 

CP/n 3 PIP Version 3.6 

30:=$.com[vor] 

3b:=%.naclvo] 

ibi=cık.kLvor] 

Xicr) 

in 

+--——------ 1777 + 
ı A Es werden nur die Dateien kopiert, bei welcren 

ı das ARCHIVE-Attribut zurückgesetzt ist (OFF). ' 
ı C Bei Vielfachkopien mit JOKERN wird bei Jeder ! 


Datei vor dem Kopieren nachgefragt ob korlert 
werden soll oder nicht (Y=Ja, N=Nein). 

Dn Lösche alle Zeichen nach dem n-ten Zeichen bis 
<cer> oder <lf> folgt. Diese Ortion dient vor allem 
zur Unterdrückung von Zeichen, wenn z.E. eın 
Drucker eine Spaltenbreite von £& Zeichen hat, der 
Quelltext aber häufig länger ist, sonst würde 
der Text auf die nächste Zeile überlaufen. 


E Echo beim Transfer von Text-Dateien auf den 
! Bildschirm. 
ı F Alle Form-Feed (Blattvorschub beim Drucker oder 


ı 

ı 

ı 

! ' 
! ! 
ı ı 
! ! 
' ' 
! ! 
ı ' 
! ! 
! ı 
ı ' 
ı 1} 
! Bildschirm löschen bei einigen Terminals) werden |! 
! unterdrückt. ' 
I! Gn Wenn n einem Quellnamen (woher) folgt, wird die ! 
ı entsprechende Datei aus der USER-Ebene n gelesen. ' 
! Wenn n einem Zielnamen (wohin! folgt, wird die ! 
! Datei in die entsprechende USER-Ebene geschrieben.! 
vH Transfer von HEX-Daten. PIP überprüft die Daten 

! auf Korrektheit, im Fehlerfalle wird dies gemeldet! 
7 :00 Dateien im HEX-Transfer werden ignoriert mit ' 
! ’]’ wird automatisch auch die H-Option gesetzt. ! 
we Mit dieser Option werden beim Kopieren von Text- |! 
! Dateien alle Grotbuchstaben in Kleinbuchstaben \ 
! gewandelt. Diese Option mub der Angabe der Ziel- |! 
! datei folgen. ı 
UN In eine Textdatei werden Zeilennummern eingefügt. ! 
! Nach jeder Zeilennummer folgt ein TAB. { 
! Notwendig beim Transfer von Binär-Dateien. Es ! 
! werden alle CNTRL-Z und EÖF-Marken ignoriert. ! 
ı Pn Textdateien werden nach jeweils n Zeilen mit einen! 
! Form-Feed unterbrochen (Seitenvorschub). ! 
! Wird die Option mit n=] oder garnicht spezifiziert! 
! erfolgt ein Form-Feed nach jeweils 66 Zeilen. \ 


Tabelle 12 Zusammenstellung der Optionen von PIP 
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Option TAB-s (CNTRL-I) durch soviele Leerzeichen 


a et 

I Gtext"Z ASCII-Datei vom Quellaufwerk kopieren bis zum ı 
Beginn der Zeichenkette <text>. Kann mit der ! 

Option 5 benutzt werden, um Textauszuege aus einer! 

! Datei zu kopieren. ! 
ıR Einzige Möglichkeit um SYS-Dateien zu kopieren ' 
I Stext”Z ASCII-Dateien von Quellaufwerk kopieren ab Beginn ! 
e = Pa | 

Tn Beim Kopieren von Textdateien werden mit dieser \ 

f 

ı 


(Blanks) ersetzt, daß das nächste Zeichen in I 
einer Spalte beginnt, die ein Vielfaches von n ist 


I y Alle Kleinbuchstaben der Quelldatei werden in 


! v Wenn die Zieladresse ein Laufwerk ist, wird die 


+ 
ı 
ı 
ı 
ı 
ı 
ı 
\ der Zeichenkette (text>. - 
ı 
ı 
ı 
f 
I 
ı 
ı 
ı 
f 
ı 
f 
ı 
ı 
ı 


! 

' 

Großbuchstaben umgewandelt. \ 
' 

ı 


kopierte Datei mit der Originaldatei noch einmal 
verglichen, um Kopierfehler zu vermeiden. 

W Möglichkeit um Rlead)-O(nly)-Dateien zu über- 
schreiben. Vorsicht !!! 


Datei zu kopieren, bei der alle Parity-Bits (Bit 7 


! 
! 
: \ 
2 Mit dieser Option ist es möglich eine ASCII- \ 
> 
ı 
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auf NULL gesetzt werden. 


noch Tabelle 12 Zusammenstellung der Optionen von PIP 
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* SID % Der Debugger 
Wr 


Syntax: 


$ID (filenane .ext)(,filenne.syn) 


Beschreibung: 


SID (Symbolic Instruction Debugger) ermöglicht es dem erfahrenen 
Programmierer, Fehler (Bugs=Wanzen) in einem neu geschriebenen 
Programm relativ schnell zu finden. 


Hierzu stehen eine Vielzahl von Hilfsmitteln zur Verfügung. Sie 
reichen von der einfachen Darstellung des Speicherinhaltes (in 
HEX und ASCII) über die Möglichkeit des Disassemblierens bis zum 
Verfolgen (tracen) eines Programmes in Einzelschritten mit fort- 
laufender Darstellung der Registerinhalte. 


Nachdem sich SID mit Namen und Versionsnummer gemeldet hat, 
werden folgende Angaben gemacht: 


NEXT MSZE PC END 
xXxX XXXX XXXX XXXX 


Damit erhält der Benutzer Angaben über die derzeitige Größe des 
Arbeitsspeichers (MSZE), die Adresse des ersten freien Speicher- 
platzes hinter einem evtl. geladenen Programme (NEXT), der End- 
adresse im Arbeitsspeicher (END) und die Einsprungadresse des 
geladenen Programmes (PC=Program-Counter). 


In der nächsten Zeile meldet sich dann der SID-Prompter '4' und 
wartet auf entsprechende Befehle. Diese sind in Tabelle 13 
zusammen gefaßt. 


SID hat für Benutzer eines Z80-Computer den Nachteil, daß er 
"nur! die Register und den Befehlssatz (und die Mnememonics) des 
8080-Prozessors kennt. 


Da heute überwiegend 280-Prozessoren mit ihrem wesentlich er- 
weiterten Befehlssatz auf dem Markt sind, wird der Benutzer in 
den meisten Fällen auf einen anderen Debugger wie z.B. TRACE-80 
oder DSD zurückgreifen oder seinen "alten' ZSID, der Z80-Version 
von SID unter CP/M 2, weiterbenutzen. In letzterem Falle sei auf 
den TPA-Befehl SAVE.COM verwiesen, wenn Dateien wieder auf Disk- 
ette zurückgeschrieben werden sollen. 


Zu SID werden noch zwei Hilfsprogramme geliefert und zwar 
HIST.UTL und TRACE.UTL. Beide Programme werden wie "normale" 
Programme nachgeladen und ermöglichen es Histogramme (HIST) zu 
erstellen oder die Daten eines Tracevorganges zu sammeln. Nähere 
Angaben hierzu sind im Handbuch von Digital Research SID (TM) 
Symbolic Instruction Debugger User's Guide (in englischer 
Sprache) zu finden. 
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4--—-- — 4... 0004 


Syntax ! Befehlsbedeutung ! 


ee namen une 


Annnn Programmeingabe in Assembler-Mnemonic (INTEL) ab |! 
Adresse nnnn. ! 
Cnnnnfa{,b})} Aufruf (Call) eines Programmes mit Start auf ! 
Adresse nnnn. Beim Aufruf koennen folgende Daten |! 
uebergeben werden! a=Inhalt des BC-Registers und |! 
b=Inhalt des DE-Registers. (Beide Register sind ! 
die (CP/M-) ueblichen Vebergaberegister. ' 
D{W)£nnnn}){,eeee} Dump (in HEX und ASCII) eines Speicherbe- ' 
reiches. Die Option W veranlasst eine Ausgabe im |! 
Wortformat (jeweils 2 Byte) nnnn gibt die Start ! 
Adresse an, eeee die Endadresse. Wird keine End- |! 
Adresse spezifiziert, werden nur die naechsten ! 
123 Bytes ausgegeben. Wird keine Startadresse \ 
angegeben, wird ab der zuletzt dargestellten ! 
Adresse (beginnend bei 106H) ausgegeben. ! 
Efilename.ext(filename.5YM) Laden eines Programmes (mit ' 
optional, seiner Symboaltabelle). ! 
EXfilename Laden der SYM(bol)-Tabelle filename.SYM im Nach- | 
gang zu Efilename.ext. ! 
Fnnnn,eeee,bb Fuellen des Speicherbereiches nnnn bis eeee ! 
mit Jem Bytewert bb. ! 
Gfnnnn)(,bt,b}} Ansprung (Go) der Adresse nnnn. Es koennen ! 
bis zu 2 Haltepunkte (b) gesetzt werden. Erreicht |! 
das Programm den Haltepunkt, wird dessen Adr. aus-! 
gegeben und in den Befehlsmodus zurueckgekehrt. ! 
Die Registerinhalte und der Stack (siehe X-Befehl)! 
entsprechen dem vorgefundenen Zustand. Wird nur ı 
ein G eingegeben, wird ab dem letzten Haltepunkt |! 
weiter gemacht, bis ein neuer Haltepunkt gefunden ! 
wird. ! 
H{aaaa(,bbbb}} Dieser Befehl allein gibt eine Auflistung aller! 
Symbole (die mit dem E-Befehl geladen wurden) aus.! 
Wird die Option aaaa benutzt,wird der entsprechende 
Wert in HEX(adezimal) Dezimal und ASCII ausgegeben! 
Werden beide Optionen (aaaa und bbbb) benutzt, ! 
wird die Summe und die Differenz beider Werte ! 
ausgegeben. \ 
Ibefehl Es kann mit diesem Befehl ein kompletter CCP- ' 
emuliert werden. Dieser wird entsprechend auf- ! 
bereitet, d.H. in die entsprechenden FCB-Puffer ' 
geschrieben, wie dies fuer jeden Befehlsaufruf ! 
aus dem CCP heraus typisch ist. ! 
L(aaaa(,eeee)) Disassembler-Listing (in INTEL-3988 Mnemonic) ab 
Adresse aaaa bis Adresse eeee. Wird nur die Start-! 
Adresse angegeben, so werden nur die naechsten 3 |! 
Zeilen ausgegeben. Wird keine Adresse angegeben, |! 
erfolgt die Ausgabe ab der zuletzt ausgegebenen ! 
Adresse beginnend bei 106H. ! 
Maaaa,eeee,dddd Transfer (move) des Speicherinhaltes von aaaa ! 
bis eeee nach Startadresse dddd. ! 
P{nnnn(,cccc})} Setzen eines permanenten (festen) Haltepunktes ! 
auf Adresse nnnn. Dieser Haltepunkt wird (falls \ 
Option gesetzt) cccc mal durchlaufen, bis er an- |! 
gezeigt wird. Wird nnnn nicht spezifiziert, werden! 
alle gesetzen Haltepunkte zurueckgenommen. 


Tabelle 13 Zusammenfassung der SID-Befehle 


+--— 4-7 + 
I Syntax I Befehlsbedeutung ' 


I Rfilename.ext(,nnnn) Einlesen einer Datei <filename.ext? nach ! 
ı Adresse 186H. Die Option gibt einen Öffset zur ' 
! Adresse 10H an, an welche die Datei dann ge- ! 
' schrieben wird. ı 
ı StW)Innnn Setzen von Speicherstellen ab Adresse nnnn. Mit \ 
\ Option W werden Speicherstellen Waortweise (2-Eyte)! 
L gesetzt, sonst Byteweise. ' 
ı TtW)Cnnnn{,cccc}) Trace (Einzelschritt-Verfolgung) eines Pro- ! 
! grammes ab Adresse P ( Programmzaehler siehe 1 
4 X-Befehl). Ist die Option nnnn gesetzt, wird ı 
! nnnn-mal ge’traced’ .Die Option cccc gibt eine \ 
! andere Startadresse als in P vorgesehen an. Mit ! 
! der Option W wird die Verfolgung von Unterpro- ! 
ı grammaufrufen unterbunden. ' 
ı UtW)Ennnnt,cecc}) Entspricht dem T-Befehl, es erfolgt jedoch |! 
\ keine Ausgabe der Registerinhalte. ' 
ı U Gibt die erste freie Speicherstelle (NEXT) an, ' 
! die naechste Speicherstelle hinter der groessten |! 
! eingelesenen Datei (MSZE), den Inhalt des Pro- \ 
! grammzaehlers (FC) und die letzte verfuegbare ı 
' Speicherstelle (END). ! 
I Wfilename .ext(aaaa,eeee) Schreiben der Datei «filename.ext> von 
' Adresse aaaa bis eeee auf Diskette. Wird keine ' 
' Startadresse angegeben wird 16H vorgegeben und \ 
\ NEXT-1 als Endadresse verwendet. ! 
ı Xtfir) Es werden die Inhalte aller CPU (2086) Register ! 
' dargestellt wenn keine Option eingegeben wurde. ! 
! mit Option f koennen die Flasbits C,E,I,M oder Z ! 
! gesetzt (1) oder zurueckgesetzt (#) werden. ! 
' Mit Option R koennen die Register A,B,D,H,F und S ! 
! veraendert werden. Nach Eingabe der Option wird 1 
\ der derzeitige Zustand bzw Wert ausgegeben, erst | 
' dann wird nach dem neuen Wert gefrast. ı 


wird die Zahl als dezimal behandelt. 


+ 

ı # Wird dieses Zeichen einer Zahl vorhangestellt, \ 
! ! 
ı Zeichen oder Zeichenketten in Hochkommas <'> } 
1 ı 


‚a 
werden als ASCII-Werte behandelt. 


Es gelten alle Kontrollzeichen des CCF-Befehls- 
Zeileneditors. ( Siehe Tabelle ] ) 

I ACHTUNG: Diese Befehle sind gegenueber dem Befehlssatz von ! 
(Z)SID in CP/M 2 erheblich erweitert und zu diesem) 
nur bedingt kompatibel. 


+ + 
ie oder 68 veranlassen einen Wiedereintritt in den ! 
! CCP (Warnstart). ! 
1 ı 
ı ı 
1 
ı 
ı 


noch Tabelle 13 Zusammenfassung der SID-Befehle 
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LE 2 2 2 2 2 2 2 2 2 2 2 2.2 2 2 2 2 2; 


* XREF * Crossreferenz-Erzeugung 
WARE a a a 


Syntax: 
XREF (3:) filenane (4P) 
Beschreibung: 


Das Programm XREF.COM ermöglicht es, eine Zusammenstellung aller 
Labels in einem Programm zu erstellen, mit Querverweisen, an 
welcher Stelle in einem Programm diese Labels aufgerufen werden. 


Unter Labels sei in diesem Falle der Name eines Programmsegmentes 
in einem Gesamtprogramm verstanden. Diese Zusammenstellung ist 
nur für Assemblerprogramme, die mit MAC oder RMAC assembliert 
wurden, möglich. Es werden dazu die PRN und SYM-Dateien benötigt. 
Beide Dateien müssen den gleichen Dateinamen haben, 


Es wird eine neue Datei filename.XRF generiert, die alle Querver- 


weise enthält. Die Option $P veranlaßt, daß die XRF-Datei nicht 
auf Diskette abgelegt, sondern auf den Drucker ausgegeben wird. 
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TEIL II Aufbau und Organisation von CP/M 3 
Eine Vorbemerkung 

Die Speicherorganisation 

Disketten- und Laufwerksorganisation 
zeiger im TPA-Bereich 


Die Dateiorganisation 
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Kapitel 1 Eine Vorbemerkung 


Im Gegensatz zum weit verbreiteten CP/M 2.2 ( und dem noch etwas 
"älteren' CP/M 1.4 ) ist CP/M 3 nicht mehr auf einen Arbeits- 
speicher von 64K beschränkt. Es können in der gebankten Version, 
und nur die ist eigentlich von Interesse, Speicher bis zu 1MB 
verwalten werden. Leider bezieht sich dies aber nur auf Daten- 
und DIR-ectory-Puffer und nicht auf die Größe des eigentlichen 
Arbeitsspeichers (der TPA). 


Da die bei CP/M 3 (CP/M Plus) benutzten Prozessoren nach wie vor 
nur 16 Bit adressieren können, ist der direkt ansprechbare Spei- 
cherbereich nach wie vor 64K groß. Um dies zu umgehen, wurde der 
größere Speicherbereich einfach in Speicherbanken (banks) zu 
jeweils 64K aufgeteilt. Zum Datentransfer wird nun im obersten 
Speicherbereich einer Bank ein Speicher-Segment zur Verfügung ge- 
stellt, auf welches von allen Banken zugegriffen werden kann. 


Dieses gemeinsame Speichersegment ist üblicherweise zwischen 4K 
und 8K groß und enthält neben dem genannten Datenpuffer auch den 
ungebankten Teil des CP/M's. 


Die Puffergrößen für Daten und DIR-ectory-Einträge können bei der 
Generierung eines Systemes relativ freizügig (nach Vorhandensein 
von Speicherplatz) bestimmt werden, mit beispielsweise nur 2 
Laufwerken wird man jedoch schnell feststellen, daß mehr als 2 
Banks nicht sinnvoll belegt werden können. 


Da heute Speicherkarten mit 1MB billiger sind als vor wenigen 
Jahren noch Speicherkarten mit 8,16 oder gar 32K, ist die Aus- 
nutzung von "'verbleibendem' Speicherplatz schon ein wichtiges 
Thema. 


Der Aufbau von CP/M 3 macht es hier bereits sehr einfach sog. 
RAMDISK's einzusetzen. Hierunter sind Pseudo-Laufwerke zu ver- 
stehen, die, mit Speicherkapazitäten bis zu rd. 800k, als sehr 
schnelle Arbeitsdisketten verwendet werden können. Gegenüber CP/M 
verhalten sie sich wie ein 'normales' Laufwerk, Ihr einziger 
Nachteil ist es, daß sie alle Daten beim Abschalten (oder Aus- 
fall) des Computers verlieren - also erst Daten retten, dann 
Gerät abschalten. Mehr zu diesem Thema in Teil V. 


Jedes CP/M System besteht prinzipiell aus 3 Programmsegmenten: 


l. Dem BIOS (Basic-Input-Output-System). Hierunter ist die 
Hardware-Anpassung an ein vorgegebenes Computersystem zu 
verstehen. 


Hier werden alle notwendigen Schnittstellen zur zeichen 

EIN- und AUS-Gabe initialisiert und bearbeitet, ebenso wie 

gewisse einfache Diskettenoperationen wie Lesen oder 

Schreiben eines Sektors und Laufwerk, Track und Seite an- 

sprechen. Dieser Programmteil ist für die meisten Computer 

sehr unterschiedlich, aber zuständig für die Funktions- 
fähigkeit und Zuverlässigkeit eines Systemes. Beispiele und 
Hinweise zum BIOS sind in Teil IV zu finden, 


2. Das BDOS (Basic Disk Operating System). Dieses Programmseg- 
ment ist das, was eigentlich unter CP/M zu verstehen ist. 


8l 


Hier werden alle Diskettenoperationen veranlaßt und über- 
wacht, ebenso wie die Zeicheneingabe und -ausgabe. Dieser 
Programmteil. zusammen mit dem BIOS muß als Mindestkonf igu- 
ration vorhanden sein, um CP/M-Programme funktionsfähig zu 
erhalten. 


3. Der CCP (Console Command Prozessor) ermöglicht es bestimmte 
Dateien (zumindest erstmals) aufzurufen sowie Dateien zu 
kopieren und Disketten zu formatieren. 


Ein Teil des CCP's ist der sogenannte LOADER (Lader), der 
sich sofort nach dem Einsprung in den CCP automatisch vor 
das BDOS legt. Es ist der Loader. der die gewünschten Pro- 
gramme lädt und aus diesen evtl. vorhandene RSX-Elemente 
übernimmt. 


Vor den Loader können, wie bereits angedeutet, sogenannte RSX- 
Dateien geladen werden (Resident System eXtension). Dies sind 
Programmteile, die in gewisser Weise eine Befehlserweiterung des 
BDOS-Segmentes zulassen. 


Der Arbeitsbereich, die sogenannte TPA (Transient Program Area), 


ist der Arbeitsspeicher ab Adresse 100H bis zum Beginn des BDOS 
bzw. einem vorgelagerten RSX. 


82 





Kapitel 2 Die Speicherorganisation 


CP/M 3 kann in seiner gebankten (segmentierten) Version RAM- 
Speicher bis zu 1MB verwalten. Notwendig zum Betrieb sind jedoch 
nur 2 Banks als Minimum mit jeweils 64K und einem gemeinsamen 
Speicherbereich von 4K bis 8K, der sog. COMMON-Area, 


FFFF Ende RAM -> +------ + 
1 I Residentes 
gemeinsamer ı BS l Betriebssystem 
Bereich Ende TPA -> I==————- ı RESBIOS, RESBDOS 
I Loader! 
DFFF (EFFF) 4+>------ + Im I tem + <- Ende Bank-RAM 
ı v4 u | l 
BNKBIOS ll BS ee | ı 1 I 
BNKBDOS l I 1 TPA ı 1 ı 
lem—m—u- ı 1 4 ı 
gebankter N ı 1 4 l 
Bereich ı ı 1 ı 1 l 
4+------ + 47 + 4------ + 
Bank 0 Bank 1 Bank 2 Bank n .2s0°+ 


Bild 1. logische Speicheraufteilung unter CP/M 3 


Es ist aus Bild 1 zu erkennen, daß Teile des Betriebssystemes 
(BS) auf Bank 0 und im gemeinsamen Speicherbereich zu finden 
sind. Der Loader ist direkt vor dem Betriebssystem im gemeinsamen 
Speicherbereich angesiedelt. Er kann in den gebankten Bereich der 
TPA (auf Bank 1) hineinreichen. 


Auf Bank 0 befindet sich vor allem die (CP/M-) interne "'Ver- 
waltung' und die Disketten- Ein/Ausgabe, während auf Bank 1 der 
BDOS-Einsprung und die BIOS-Sprungtabelle mit den zugehörenden 
Vektoren auf den Adressen 0000H und 0005H liegt, wie dies von 
CP/M 2 gewohnt ist. 


Die TPA, d.h. der Arbeitsspeicher-Bereich in welchem die Pro- 
gramme ablaufen, ist in Bank l angesiedelt. In dieser Bank sind 
auch alle CP/M typischen Speicherbelegungen im Speicherbereich 
0..100H. 


In Bank 0 werden darüberhinaus die Puffer für das Inhaltsver- 
zeichnis (DIR-ectory) abgelegt und, falls gewünscht, eine sog. 
Hash-Tabelle. (diese hat nichts mit "Rauchen! zu tun, sondern 
ermöglicht es dem Betriebssystem über die in der Tabelle abgeleg- 
ten Zeiger (Vektoren) schneller einen Eintrag im Inhaltsverzeich- 
nis zu finden.) 


Die Größe der Puffer für das Inhaltsverzeichnis kann (solange der 
Speicherplatz ausreicht) frei gewählt werden. Ideal ist die Zu- 
weisung einer Puffergröße, die das gesamte Inhaltsverzeichnis 
aufnimmt. (z.B für je 32 Einträge * 32 Bytes=1024Bytes=1K). Bei 
einer Puffergröße von IK und 128 Dir-Einträge entspräche dies 
einer Zuweisung von 128/32 = 4 Puffern). 


Zuweisungen, die größer als der vom Inhaltsverzeichnis benötigte 
Raum ist, sind natürlich möglich aber nicht sinnvoll. Steht nicht 
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genügend Speicherkapazität zur Verfügung oder müssen Puffer für 
mehrere Laufwerke zugewiesen werden, können natürlich auch klei- 
nere Puffer verwendet werden. Es werden dann eben nur Teile des 
Inhaltsverzeichnis abgelegt, was einen häufigeren Diskettenzu- 
griff zur Folge hat. Die Mindestpuffergröße ist '1', 


Ist noch Platz in Bank 0, kann dieser mit Datenpuffer für jedes 
Laufwerk belegt werden. 


In diesen Pufferbereich werden alle Daten, die von Diskette 
gelesen oder dorthin geschrieben werden, transferiert, um von 
hier aus schneller auf die Laufwerke zugreifen zu können, ohne 
erst kleine Segmente hin und her zu schieben. Die Größe dieser 
Puffer sollte möglichst der Blockgröße entsprechen, zumindest der 
Sektorgröße. Stehen mehr als 2 Banken zur Verfügung, werden 
Datenpuffer, die nicht mehr in Bank 0 passen, auf diese verteilt. 


Die Datenpuffer dienen dem (internen) blocking- deblocking, das 
von CP/M 2 noch vom BIOS übernommen werden musste. 


Zugegebenermaßen klingt dies alles etwas kompliziert, vcr allem 
wenn man bedenkt, daß noch andere Puffer zugewiesen werden müs- 
sen, aber keine Angst: die ganze Zuweisung übernimmt das Gen- 
erierprogramm GENCPM. Näheres hierzu in einem späteren Kapitel 
(Hardware-Anpassung). 


Aus der Speicheraufteilung und dem bisher beschriebenen, kann er- 
kannt werden, daß die BIOS-Einsprungtabelle zwar im gemeinsamen 
Speicherteii liegt, aber alle Unterprogramme die mit dem Zugriff 
auf Disketten zu tun haben liegen in Bank 0. 


Nun zeigt zwar die BIOS-Sprungtabelle auf die richtige Adresse, 
aus einem TPA-Programm heraus gesehen ist aber ein Zugriff auf 
die Adresse der einzelnen Unterprogramme nicht (so ohne weiteres) 
möglich, da die TPA ja in Bank 1 liegt. 


Hierin ist der Grund zu suchen warum einige Hilfsprogramme, die 
für CP/M 2 geschrieben wurden und gewisse Disketten-Operationen 
ausführen konnten, unter CP/M 3 nicht mehr funktionieren; diese 
Programme wurden alle mit direkten Aufrufen in das BIOS geschrie- 
ben. Zu diesen Programmen gehören Disketten'reparierer' wie DU, 
DISKDOCTOR, POWER und SUPERZAP. Fast alle diese Programme sind 
heute in neuen Versionen erhältlich, die entweder nur unter CP/M3 
oder auch unter den alten Versionen funktionsfähig sind, 


CP/M 3 besteht wie CP/M 2 aus mehreren Programmteilen, die nach 
einem ganz bestimmten Schema in Bank 1, der TPA-Bank zusammenge- 
setzt werden. Immer resident sind die Programmteile BIOS und 
BDOS. Sie bilden den Kern des Betriebssystenmes. Zugriff auf diese 
beiden Programmteile erhält der Benutzer über Einsprungadressen 
auf Adresse 00004, auf die Warmstartadresse im BIOS und über die 
BNPBrungedranne 0005H auf das BDOS, jeweils aus dem TPA-Bereich 
eraus. 


Das BIOS (Basic Input/Output System) ist der hardware-abhängige 
Teil des Betriebssystemes, während das BDOS (Basic Disk Operating 
En die gesamte Diskettenverwaltung (unveränderbar) über- 
nimmt. 


Das BIOS wird normalerweise vom Systemlieferanten angepasst und 
kann vom Kunden modifiziert und erweitert werden. Das BDOS ist 
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der invariable Teil des Betriebsystemes wie er von Digital Re- 
search INC, USA geliefert wird. Dieser Teil des Betriebssystemes 
wird in Form der Dateien BNKBDOS3.SPR und RESBDOS3.SPR zur Verfü- 
gung gestellt, im Falle eines ungebankten Systemes als Datei 
BDOS.SPR. (Siehe hierzu Bild 2). 


FFFFH 44-44 + 
1 BIOS: hardware EIN/Ausgabe System l 
4+------- + 
1 BDOS: Diskettenverwaltung ı 
4+---------- + 
Option: I LOADER: Programm Lader Modul ı 
4+-=--------- + 
I RSX: residente System Erweiterung(en) l 
4+------------- + 
ı l 
ı TPA I 
ı ı 
l I 
ı l 
l 4+------------ + 
ı 1 CCP: Benutzer Befehlsinterface l 
0100H 4e-----4---- mn + 
0000H I 0-Bereich - von CP/M reserviert ı 
4+---------- nn + 


Bild 2 Belegung von Bank 1 


Der LOADER und die/das RSX-Modul(e) sind CP/M3 typische Erweite- 
rungen des Betriebssystemes. Mit diesen Modulen kann CP/M auf 
Benutzerebene ergänzt, erweitert oder verändert werden. 


Aufgabe des Loaders ist es, TPA-Programme und RSX-Module zu 
laden, wobei TPA-Programme immer nach Adresse 100H geladen wer- 
den, während dies bei RSX-Programmen etwas komplizierter wird. 


Bei RSX-Programmen wird der RSX-Teil direkt vor den Loader 'ge- 
laden'; der BDOS-Einsprung unter Adresse 0005H wird auf die RSX- 
Startadresse umgeändert und das zum RSX gehörende Programm wird 
"ganz normal! nach 100H geladen. Jeder BDOS-Aufruf wird danach 
zuerst über das RSX-Modul geleitet bevor er den BDOS-Einsprung 
erreicht, er kann also vorher in jeder beliebigen Weise "'behan- 
delt' werden. 


Der Dialog Benutzer-CP/M erfolgt über das Programm-Modul CCP. 
Dieses Modul ist unter CP/M 3 nicht mehr Teil des Betriebs- 
systemes, sondern ein TPA-Programm mit Startadresse 100H wie dies 
für TPA-Programme üblich ist. 


In der gebankten Version wird bei jedem Warmstart der CCP-Pro- 
grammteil jedoch nicht von der Diskette nachgeladen, sondern aus 
einer Bank, in welche der CCP vom BIOS bereits beim Kaltstart 
transferiert wurde. Dies hat den Vorteil, das nach dem Booten 
auch Disketten ohne Betriebssystem bearbeitet werden können. 


Auf welcher Bank und Adresse der CCP zwischengespeichert wird, 
bestimmt der Systemprogrammierer. Näheres ist normalerweise aus 
der BIOS-Datei BOOT zu entnehmen. Im Übrigen kann dies dem Be- 
nutzer auch recht einerlei sein, da er auf den entsprechenden 
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Speicherbereich nicht so ohne weiters Zugriff hat. Für ihn von 
Bedeutung ist nur der schnelle Zugriff auf den CCP ohne Lauf- 
werksaktivitäten. 


Vergleicht man, auf das Banking bezogen CP/M 3 mit CP/M 2, so muß 
man klar erkennen, daß sich alles "Wesentliche! bei CP/M 3 auf 
Bank 1 abspielt, denn dort ist die TPA, wärend bei CP/M 2 die TPA 
in Bank 0 war. 


Dies spielt normalerweise für den Anwender keine Rolle, wenn aber 
ein neues BIOS installiert werden soll, so ist dieser Punkt doch 
zu berücksichtigen, wenn z.B. Unterprogramme aus dem Monitor 
heraus getestet (entwanzt) werden müssen. 


Sollte dennoch einmal das Problem auftreten, Programme oder Pro- 
grammteile von Bank 0 nach Bank 1 zu transferieren, so kann hier 
ein gutes Monitorprogramm sicher sehr hilfreich sein. Für den 
Transfer bietet sich, falls das Monitorprogramm dies nicht direkt 
übernehmen kann, immer der gemeinsame Speicherbereich an. 
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Kapitel 3 Disketten- und Laufwerksorganisation 


CcP/M3 kann bis zu 16 Laufwerke mit bis zu 512M-Byte Kapazität 
unterstützen. Jedes Laufwerk wird durch einen Buchstaben im Be- 
reich A..P identifiziert. "Laufwerk' kann prinzipiell jedes 
Floppy-Disk Laufwerk sein, jedoch auch Harddisks und Ramdisks 
und notfalls auch Kassettengeräte, wobei hier der Zugriff recht 
langsam werden kann. 


Die Aufteilung auf einer Diskette ist im allgemeinen von aussen 
nach innen. 


Track M SE SE + 
I CP/M 3 Datenbereich ( Programme ) ı 
Datentracckhö HA an —— + 
1 CP/M 3 Datenbereich ( Programme ) l 
4e--- + 
I CP/M 3 Directory Bereich l 
Track N ESS Bar sense ae ne + 
I CCP ( Optional ) \ 
Systen Track + 
I CPMLDR ( Boot-CP/M ) l 
4+----------- + 
ı Kaltstart-Lader ı 
Track 0 be Abk ln Zn Sul nl a1 22 + 


Bild 3 Aufteilung von Disketten 


Wie in Bild 3 gezeigt, stellen die ersten N Tracks die soge- 
nannten Systemspuren dar. Sie werden nur auf Disketten benötigt, 
welche CP/M 3 booten sollen, Hierunter ist das Laden des CP/M- 
Betriebssystemes zu verstehen. Die Anzahl der belegten System- 
spuren ist unter CP/M 3 recht unterschiedlich, meist sind sie 
überbelegt (genauer gesagt leer), um mit dem Format der älteren 
CP/M 2 Disketten kompatibel zu bleiben, 


Der Loader benötigt kaum mehr als 4..5K Speicherplatz, die rest- 
lichen Sektoren bleiben leer. 


Das Laden des Betriebssystemes selbt geschieht in mehreren 
Schritten: 


l» Nach dem Einschalten ( oder nach Reset ) meldet sich das 
Monitorprogramm als unterste Ebene. 


2. Manuell kann nun gebootet werden ( Siehe hierzu Monitor- 
Handbuch oder sonstige "Kaltstartvorschriften' des benutzen 
Gerätes). 


3» Der Monitorboot lädt seinerseits den Kaltstart-Lader von 
Track 0, Sektor 1 auf der boot-Diskette.Der Kaltstart-Lader 
wird nach Adresse 0, Bank 0 geladen, 


4. Der Kaltstart-Lader lädt nun den CPMLDR. Dies ist ein "abge- 
magertes' CP/M mit Sonderfunktionen und einem nur auf "Le- 
sen' und Zeichenausgabe geschrumpften BIOS . 

5. Der CPMLDR lädt nun seinerseits die Programmteile CPM3.SYS 
- dies ist das eigentliche Betriebssytem - und verteilt 
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dieses auf die Systembank 0 und den gemeinsamen Speicherbe- 
reich, aus welchem auf alle Banken zugegriffen werden kann. 


6. Ist die Verteilung erfolgt, wird der an das Betriebssystem 
angelinkte Programmteil BIOS angesprungen. 


Ts Das Programmsegment BOOT ( im BIOS ) lädt nun das TPA- 
Programm CCP.COM ( auch nach Bank 0 zur Wiederverwendung ) 


8. Nachdem BIOS alle Parameter initialisiert hat, wird CCP 
exekutiert --- CP/M 3 ist aktiv . 


I, Ist auf der Diskette eine Datei PROFILE.SUB vorhanden, so 
wird deren Befehlsinhalt vom CCP ebenfalls noch abgearbei- 
tet, bevor sich das System mit dem gewohnten Prompter 'A>"' 
meldet. 


Dieser Boot-Vorgang ist üblicherweise nur nach dem Einschalten 
des Gerätes notwendig und nur beim Booten müssen die Systemtracks 
den Kaltstart-Lader und CPMLDR und die Datentracks die Pr:gramme 
CPM3.SYS ( mit angepaßtem BIOS ) und CCP.COM enthalten. 


Mit PROFILE.SUB können beim booten verschiedene Systemparameter 
gesetzt werden. Typische Befehle sind Datumabfrage, Zuweisungen 
von Zusatzgeräten und die Reihenfolge in der die Laufwerke nach 
Programmen abgefragt werden sollen. (Also ein Aufruf der TPA- 
Befehle SETDEV, SET und DATE) 


Nach dem boot-Vorgang kann die Boot-Diskette entfernt werden und 
eine andere (formatierte) Diskette eingefügt werden. 


Das von CP/M 2 "gewohnte! CNTRL-C hat nach wie vor die gleiche 


Funktion, es erfolgt jedoch kein Diskettenzugriff - lediglich der 
Befehlsinterpreter CCP.COM wird aus einer Bank nachgeladen. 


88 


Kapitel 4 Zeiger im TPA-Bereich 


Ebenso wie unter CP/M 2 sind verschiedene Speicherbereiche für 
das Betriebssystem reserviert, über die CP/M mit dem CCP und den 
von diesem aufgerufenen Programmen verkehrt. Solche 'Software- 
Schnittstellen! sind notwendig, da jedes CP/M-Betriebssystem je 
nach Konfiguration unterschiedliche Startadressen haben kann. 


Unter CP/M 3 gibt es vor allem 2 Bereiche, die der gegenseitigen 
Verständigung dienen. 


Allen voran - und CP/M 2 kompatibel - der Speicherbereich von 
0...100H in Bank 1, der TPA-Bank. Die einzelnen Adressen haben 
dabei folgende Bedeutung: 


0000H Einsprungadresse in die Warmstartroutine des BIOS. 


Hier ist ein direkt ausführbarer Sprung implementiert, 
der aus jedem Programm heraus aufgerufen werden kann. 
Wird der Sprung ausgeführt, wird der CCP nachgeladen 
und angesprungen. Das System meldet sich mit dem be- 
kannten Prompter '>'. 


0001H Hier steht der Zeiger auf die Startadresse des BIOS 
(genauer gesagt auf den Einsprung WBOOT) 


Diese Adresse wird vor allem zur Berechnung von direk- 
ten BIOS-Einsprüngen benutzt. 


0005H Einsprungadresse in das BDOS oder einer vorgelagerten 
RSX-Datei, aber auch SID & Co, 


Dies ist die wichtigste Adresse in jedem CP/M-System, 
denn über diese Adresse laufen ALLE Funktionen, selbst 
die Ein- oder Ausgabe der Konsole, 


0006H Hier steht die Startadresse des BDOS oder einer vorge- 
lagerten RSX-Datei. 


Diese Adresse ist gleichbedeutend mit der obersten, 
frei zur Verfügung stehenden Speicherstelle der TPA, 


0038H Diese Adresse (RST8) wird unter gewissen Voraussetzun- 
gen von SID & Co benötigt,wenn Haltepunkte beim Debug- 
gen verwendet werden. 


Wird in der Befehlszeile des CCP (oder mit dem I-Befehl in SID) 
ein Programm mit Optionen oder Zusatzprogrammnamen aufgerufen, 50 
werden diese Daten auf die nachstehend genannten Adressen, wie 
dort angegeben, verteilt. Jedes Nachfolgeprogramm kann diese 
Daten aus dem entsprechenden Speicherbereich nutzen. (Siehe hier- 
zu auch Teil V) 
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0050H Laufwerksbezeichnung von welchem die Datei geladen 
wurde. (01=A,02=B usw. 00 bedeutet, daß keine beson- 
dere Laufwerksangabe gemacht wurde, in diesem Falle 
ist immer das benutzte Laufwerk gemeint. (Das Laufwerk 
von dem aus ein Programm aufgerufen wurde). 


0051H Paßwortadresse der 1. Datei in der Befehlsfolge. 

0053H Paßwortlänge der 1. Datei. 

0054H Paßwortadresse der 2. Datei in der Befehlsfolge. 

0056H Paßwortlänge der 2. Datei in der Befehlsfolge. 

005CH FCB ( Dateikontrollblock ) der l. Datei, beginnend mit 
der Laufwerksangabe (00, 01 usw). 

005DH Dateiname in Großbuchstaben auf 8 Stellen aufgefüllt 
mit Leerzeichen. 

0065H Index des Dateinamen in Großbuchstaben, auf 3 Stellen 
aufgefüllt mit Leerzeichen. 

006CH FCB der 2. Datei, beginnend mit der Laufwerksangabe. 

006DH Dateiname der 2. Datei in Großbuchstaben, auf 8 Stel- 


len aufgefüllt mit Leerzeichen. 


0075H Index des Dateinamen in Großbuchstaben, auf 3 Stellen 
aufgefüllt mit Leerzeichen. 


Adresse 80H wird vom CCP als DMA-Puffer (mit 128 Byte Größe) 
vorgegeben. 


0080H Hier steht die Länge der eingegeben Befehlszeile. 

0081H Hier beginnt der komplette Text der Befehlszeile je- 
doch in Groß- und Kleinschreibung, so wie vom Benutzer 
eingegeben, 


Unter CP/M 3 steht ein weiterer Block mit Daten zur Verfügung, 
auf welchen alle Programme direkt zugreifen können: der SCB 
(System Controll Block). Der Zugriff kann jedoch nur über einen 
BDOS-Aufruf erfolgen. Die Daten, die im SCB abgelegt sind, können 
aus dem in Teil IV abgedruckten Listing entnommen werden. 


Der SCB liegt im gemeinsamen Speicherbereich und dient dem Daten- 


austausch von CCP, BDOS und BIOS. kann aber auch nützliche Daten 
für ein TPA-Programm enthalten. 
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Kapitel 5 Die Dateiorganisation 


Alle TPA-Programme leiten ihre Dateienbearbeitung und ihre Ein- 
Ausgabe über sogenannte BDOS-Calls. Die Konventionen hierzu sind 
die gleichen wie sie bereits von CP/M 1 und CP/M 2 her bekannt 
sind, 


Programme, die nicht alle Ein/Ausgabe-Funktionen von BDOS-Calls 
ableiten, sondern Ports zur Diskettenverwaltung oder Ein/Ausgabe 
direkt ansprechen, sind nicht CP/M kompatibel. Hier ist unter 
kompatibel zu verstehen, daß ein Programm, falls es auf ein 
passendes Diskettenformat überspielt ist, auf jedem CP/M-Computer 
funktionieren soll(te). Einzige Ausname kann u.U. die Konsolen- 
ausgabe sein, soweit es sich um z.B. Cursoradressierung handelt 
oder um Attribute wie Blinken, Halbhell usw. Dies Vorbedingungen 
müssen jedoch spezifiziert sein und u.U. anpaßbar an unterschied- 
liche Ausgabegeräte. 


Es ist gerade diese verlangte Kompatibilität, die es nicht ge- 
stattet spezielle Grafiktreiber einzubinden und damit 'Bild- 
schirmspielchen', wie diese bei anderen Computern möglich sind, 
allgemeingültig einzubinden. 


Die Verwendung von BIOS-Aufrufen unter Umgehung des BDOS kann, 
wie der Übergang von CP/M 2 auf CP/M 3 zeigt, ebenfalls Inkompa- 
tibilitäten mit sich bringen, wobei unter CP/M 3 hierzu keinerlei 
Notwendigkeit mehr besteht diesen Weg zu beschreiten. (Siehe 
hierzu BDOS-Funktion 50 in Teil III). 


Alle Daten, die mit der Dateienverwaltung auf einer Diskette zu 
tun haben, werden über einen sogenannten File Control Block (FCB) 
verwaltet. Diese Datenstruktur erlaubt es CP/M, in einem 32 Bytes 
großen Datenblock alle Informationen über eine vorhandene oder 
neu zu eröffnende Datei zu erhalten. Der Aufbau dieses Daten- 
blocks ist wie folgt: 


0123456 7 8 91011 12 13 14 15 
4e-4- 4-44 444444 
ldr!fl1f21f31f4 1 E51 f61ETIEBIELIt2It3lex!slis2ircl 
4-4 4-4 4444444 
1d01d11d21d31d41451d61471A8 1AYLdA!dB!ÄCISDIdELdFI 
4eate=tendendentende nt 4n 444 

16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 


4e-4- 44 + 
lcr!rOlrli!ir2! 
4-4 4-47 + 
32 33 34 35 


Mit folgender Bedeutung: 


dr Laufwerkscode 0..16 entsprechend Laufwerk A..P bzw. 0 
für das eingeloggte (default ) Laufwerk, 


fl..£8 enthält den Dateinamen in ASCII mit Bit 7=0. Der 
Dateinamen muß in fl beginnen, verbleibender Raum, 
falls der Dateinamen kürzer als 8 Zeichen ist muß mit 
Blanks (20H) gefüllt werden. Das 8. Bit jedes Zeichens 
kann von CP/M gesetzt sein und enthält dann Datei- 
Attribute. ( siehe BDOS-Funktion 30 ) 
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tl..t3 Enthält den Index (TYP-Name) einer Datei in ASCII mit 
Bit 7=0. Ist Bit 7 gesetzt zeigt dies auf Datei- 
Attribute dabei gilt: 


€1 READ-ONLY Datei ( nur lesen ) 
t2 System-Datei ( nur mit DIRS aufzeigen ) 
t3 Archiv-flag 
ex Enthält das EXtend-Flag. Vom aufrufenden Programm üb- 


licherweise auf 0 gesetzt. Der EXtend wird vom BDOS 

gesetzt, wenn eine Datei nicht in einen einzelnen FCB 
paßt. Jeder zusätzliche Extent erhält dann einen eig- 
genen, im übrigen völlig gleichen FCB zugewiesen. 


sl,s2 CP/M reserviert zum Systemgebrauch, wird üblicherweise 
auf 0 gesetzt. 


rc zähler der 128-Bytes Segmente, in welchen CE;M die 
Dateien unterteilt. RC gibt also die Dateilänge in 
logischen Sektoren an. 


d0..dF CP/M reserviert zum Systemgebrauch. Hier werden ver- 
schlüsselt die Sektor- und Tracknummern abgelegt,unter 
welchen die Datei abgelegt ist. 


Der Teil wie bisher beschrieben wird im Inhaltsverzeichnis von 
CP/M ( der DIRectory) abgelegt. Die weiteren FCB-Plätze sind nur 
innerhalb des Disketten-Bearbeitungsprogramm von Interesse. 


er Gibt die z.2. zu lesenende- oder schreibende Segment- 
nummer an. Muß vom age auf 0 gesetzt werden, wenn 
eine Datei eröffnet wird. 


r0..r2 optionale RANDOM-Segment Nummer im Bereich 0-3FFFFFH 
(0..262143). Dies entspricht einem 18 Bit Wert wobei 
r0 das LOW-Byte und r2 das HIGH-Byte repräsentiert, 


Dieser FCB ist im übrigen für jede dort aufgenommene Datei iden- 
tisch mit dem DIR-ectory-Eintrag, soweit es die Bytes 0..15 be- 
trifft. In Teil V ist zu diesem Thema noch mehr zu finden. 
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Kapitel 1 Einführung in die Vereinbarungen 


Alle Programme kommunizieren mit CP/M über zwei Software-Schnitt- 
stellen, den Adressen 0000H und 0005H in der TPA. Über Adresse 0 
wird ein Rücksprung auf Systemebene veranlasst (hier wird ledig- 
lich der CCP nachgeladen und als Programm ausgeführt), während 
über Adresse 0005H alle Funktionen der Kommunikation, wie sie ein 
Programm normalerweise benötigt, erledigt werden. 


Jeder Aufruf der Adresse 0005h, ein sog. BDOS-call oder BDOS- 
Aufruf, benötigt bestimmte Konventionen. Hierfür sind zwei CPU- 
Register zur Datenübergabe vorgesehen, 


vor jedem BDOS-Aufruf müssen die nachfolgenden Register mit den 
genannten Daten geladen werden: 


In Register C wird eine Funktionsnummer übergeben, 
Entsprechend dieser Funktion weiß das 
BDOS was zu tun ist, 


In Register DE werden je nach Funktion Zeiger oder 
Daten übergeben, die das BDOS u.U. 
benötigt. 


Byte-Werte werden in Register <E> über- 
geben, Adressen und Vektoren im Doppel- 
register <DE>. 


Hat das BDOS die gewünschte Funktion abgearbeitet, werden, falls 
dies notwendig ist, entsprechende Daten in den folgenden Re- 
gistern zurückgegeben: 


In Register A Bytes aus Eingabefunktionen oder 
Fehlermeldungen. 

In Register HL zeiger auf Datenfelder oder 
Fehlermeldungen 


Die Register C und DE enthalten bei der Rückkehr ungültige Daten 
(außer bei Funktion 50). Auf diese Inhaltsveränderung der Re 
gister A(F), HL, DE und BC ist in jedem Falle zu achten, falls 
dies entsprechenden Registerinhalte bei einem BDOS-Aufruf nicht 
verändert werden dürfen. 


Ein BDOS-Aufruf könnte innerhalb eines (Assembler-)Programmes 
also etwa wie folgt aussehen: 


1 al’ GE er ld 6,15 ı Funktion Dateı eroeffnen 
2 6003’ 11 Omar’ id de,fcb ; File-control-Elock 

3 es" CD 05 call MmSH ; EINS Autrut 

4 6609' 67 or a ; Fehler ? 

5 aA’ 28 03 jr z,next ; wenn nicht 

6 BOac' Ka mp ı Fehlerbehandiung 
8 er next! map ; hier gehts weiter 

ER ret 


10 ee ee fde: ds 32 


95 


Diese Vereinbarung macht es jedem Programm, welches Register 
direkt bearbeiten kann, einfach mit CP/M zu verkehren. Hoch- 
spachen-Programme wie BASIC, PASCAL oder FORTRAN haben entsprech- 
ende Treiber eingebunden. Der Benutzer braucht sich dort nicht 
mehr um obige Konventionen zu kümmern. 


In den nachfolgenden Kapitel werden alle möglichen BDOS-Aufrufe 


zusammengefaßt. Beispiel der Anwendung werden im Kapitel 4 dieses 
Abschnittes in Form von Listings gezeigt. 
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Kapitel 2 Die CP/M 2 kompatiblen BDOS-Aufrufe 


Die nachfolgenden Funktionen sind mit Ausnahme der Funktionen 7 
und 8 kompatibel zu den Funktionsaufrufen unter CP/M 2. Sie 
können also in allen Programmen verwendet werden, die unter 
beiden CP/M-Versionen störungsfrei funktionieren sollen, 


Einige Funktionen wie z.B. Funktion 9, "können! unter CP/M 3 
mehr, als dies unter CP/M 2 der Fall war; dies bedeutet in diesem 
Zusammenhang jedoch nur, daß bestimmte neue "features! unter CP/M 
2 ar vorhanden sind, die Funktion selbst bleibt davon unbe- 
rührt. 


Im umgekehrten Falle, CP/M 2 Programme unter CP/M 3, sind normal- 
erweise ebenfalls keine Störungen zu befürchten. 


Es gibt hierbei jedoch zwei Ausnahmen: die Funktionen 7 und 8. 
Unter CP/M 2 wird mit dieser Funktion das IO-Byte gelesen bzw. 
verändert. Mit dem IO-Byte konnte, ähnlich wie mit DEVICE, unter 
gewissen Umständen eine Art Umlenkung (redirection) der Ausgabe- 
Kanäle vorgenommen werden. 


Diese Umlenkung war prinzipiell von CP/M vordefiniert. Sie wurde 
jedoch immer vom BIOS bestimmt. In vielen Implementationen wurde 
das IO-Byte überhaupt nicht berücksichtigt. 


Sollten CP/M-2 Programme unter CP/M 3 durch die IO-Byte-Funktion 
Schwierigkeiten bereiten, so empfiehlt es sich u.U., diese Funk- 
tion durch ein RSX-Programm abzufangen und entsprechend den Gege- 
benheiten anzupassen. 


Beim Ablauf von CP/M 2-Programmen unter CP/M 3, ist auf jeden 
Fall, beim Auftreten von Fehlern, zu prüfen, inwieweit u.U. 
direkte Aufrufe des BIOS zur Diskettenbearbeitung die Fehler- 
quelle sein können. Sollte dies der Fall sein, so kann evtl. das 
am Ende dieses Teiles abgedruckte RSX-Programm RSX22 Abhilfe 
schaffen. 


Nachstehend folgt eine Zusammenstellung aller CP/M-2 kompatiblen 
BDOS-Funktionen. 
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de=aanmmmsn- mann em mem mm mn mm mm 
i Funktion 0 SYS-Reset ı 
4------------ + 
I Eingabe C=00H l 
4+------------- + 


Mit dieser Funktion wird ein Warmstart von CP/M veranlaßt. 


Diese Funktion hat die gleiche Wirkung wie ein Sprung nach Adres- 
se 0. Nach diesem Funktionsaufruf wird der CCP aus dem Bankbe- 
reich neu geladen und exekutiert. Er meldet sich mit dem ent- 
sprechenden Prompter. 


+------------ - -------- + 

I Funktion 1 CONSOL Eingabe ı 

4=---------- nn + 

I Eingabe C=01H ı U 
I Zurück A=ASCII Eingabe l 
4=---------------- + 


Diese Funktion liest ein Zeichen von der Eingabe-Konsole, 


Alle darstellbaren Zeichen sowie CR, LF und BS werden auf die 
Ausgabe-Konsole ausgegeben. TAB's werden auf jede 8. Spalte ex- 
pandiert. 


Es wird auf CNTRL-S als Haltesignal und CNTRL-Q als "Weiter'- 
Signal reagiert. Mit CNTRL-P kann der Drucker zu- oder abge- 
schaltet werden. 


Der Funktionsaufruf kommt nicht zurück, bevor ein Zeichen einge- 
geben wurde, 


+--------------------- + 
li Funktion 2 CONSOL Ausgabe I 
47------------------ + 
il Eingabe C=02H ı 
ı E=ASCII-Zeichen ı 
4----------------- + 


Das Zeichen in Register <E> wird auf die Konsole ausgegeben. 


Wie unter Funktion 1 werden TAB's expandiert und CNTRL-S und @) 
CNTRL-Q sowie CNTRL-P bearbeitet, 

+--=--------------- nn + 

I Funktion 3 AUX Eingabe l 

47 ------------------ + 

I Eingabe C=03H I 

I Zurück A=Eingabe-Zeichen l 
4H-------------------- + 


Diese Funktion liest ein Zeichen vom AUX-Port. 


Kontrollzeichen erhalten keine "Sonderbehandlung', sondern werden 
ausgegeben wie sie sind. 
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Funktion 4 AUX Ausgabe l 
44 -------- + 
ı Eingabe C=04H l 
l E=Ausgabe-Zeichen l 


demmunnnnnn Au nun nn + 


Diese Funktion gibt das Zeichen in Register <E> auf den AUX-Port 
aus. 


Kontrollzeichen erhalten keine "Sonderbehandlung', sondern werden 
ausgegeben wie sie sind. 


4=-=------ on nn + 
I Funktion 5 PRINT Ausgabe l 
4=--------- .u--- nm + 
ı Eingabe C=05H ı 
l E=ASCII-Zeichen l 
4--------- m + 


Das Zeichen in Register <E> wird auf den Drucker ausgegeben. 


Das 8. Bit wird von dieser Funktion nicht maskiert. Es können 
also auch Grafik-Zeichen ausgegeben werden, falls dies vom BIOS 
zugelassen wird, 


4e=-------- nn + 
Il Funktion 6 Konsolen Ein-/Ausgabe direkt l 
4+-------------- men + 
I Eingabe C=06H ! 
ı E=OFFH Eingabe/Status l 
ı E=0FEH Status l 
ı E=0FDH Eingabe ! 
l E=ASCII Ausgabe ! 
I Zurück A=sASCII-Zeichen ! 
l oder A=00/FF für Status ! 
4--------- mem + 


Mit dieser Funktion können Zeichen in Register <E> unter Um- 
gehung aller Prüfungen (wie dies in Funktion 1 und Funktion 2 
der Fall ist) direkt auf die Konsole ausgegeben werden. 


Ist Register <E>=FF, wird die Konsolen abgefragt ob ein Zeichen 
(von der Tastatur) vorliegt. Liegt ein Zeichen an, wird dieses 
in <A> zurückgegeben. Liegt kein Zeichen vor, wird A=00 zurück- 
gegeben. 


Ist Register <E>=FE, wird nur der Status überprüft. Liegt ein 
Zeichen vor, wird A=FF zurückgegeben andernfalls wird A=00. 


Ist Register <E>=FD, wird auf eine Eingabe gewartet. Die Funktion 
kehrt in diesem Falle nicht vor Eingabe eines Zeichens zurück. 
Enthält Register <E> ein ASCII-Zeichen, wird dieses an die Kon- 
sole ausgegeben wie es ist. 


Ob das 8. Bit maskiert ist oder nicht, hängt von der Implementa- 
tion des Treibers im BIOS ab, 
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I Funktion 7 AUX Eingabestatus l 
4=+----------- + 
ı Eingabe C=07H l 
I Zurück A=Status I 
4=---------- --- ---- + 


Diese Funktion prüft den aktuellen Eingabestatus des AUX-Kanales, 


Liegt eine Eingabe vor, wird Register A=00, liegt keine Eingabe 
vor wird, A=FF, zurückgegeben, 


Unter früheren Versionen von CP/M wurde diese Funktion genutzt, 
um das IO-Byte zu lesen, 


+---------------- + 
I Funktion 8 AUX-Ausgabestatus Il U 
4------------- + 
I Eingabe C=08H l 
l A=Status l 
4--------------- + 


Diese Funktion prüft den aktuellen Ausgabestatus des AUX-Kanales,. 


Liegt eine Eingabe vor, wird Register A=00, liegt keine Eingabe 
vor, wird A=FF zurückgegeben, 


Unter früheren Versionen von CP/M wurde diese Funktion genutzt, 
um das IO-Byte zu setzten. 





+------------------- + 
I Funktion 9 Textausgabe ı 
4--------------------- + 
I Eingabe c=09H l 
ı DE=Textstart ı 
+---------------- nn + 


Mit dieser Funktion können Texte beliebiger Länge ausgegeben 
werden. 


Textabschluß muß ein '$'-Zeichen sein (dieses kann mit dieser 

Funktion NICHT ausgegeben werden). TAB's werden expandiert, 

ebenso wird auf CNTRL-S (Stop), CNTRL-Q (Weiter) und CNTRL-P 

(Drucken) geprüft. Nach CNTRL-Q kann mit CNTRL-C die Ausgabe & 
abgebrochen werden. 


Mit Funktion 110 (nur unter CP/M 3) kann das Textende-Zeichen 
auf jedes beliebige andere ASCII-Zeichen umdefiniert werden, 
falls das '$'-Zeichen innerhalb eines Textes benötigt wird. Es 
ist jedoch zu berücksichtigen, daß diese Umdefinition sicher- 
heitshalber vor jeder entsprechenden Anwendung erfolgen sollte, 
da der CCP bei jedem Warmstart die ursprüngliche "$'-Installation 
wieder einführt. 


Das Textende-Zeichen wird nicht ausgegeben, 
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I Funktion 10 Texteingabe ı 
4=---- - [in in nn nn nn + 
I Eingabe C=0AH l 
l DE=Pufferadresse I 
4-------- + 


Diese Funktion schreibt die Zeichen, die über die Konsole 
eingegeben werden, in einen Puffer. 


Die Startadresse des Puffers wird im Doppelregister <DE> überge- 
ben. Die Texteingabe wird durch CR abgeschlossen oder falls die 
maximale Vorgabelänge erreicht wurde. 


Der Puffer muß wie folgt aufgebaut sein: 


DE +0 +1 +2 +3 .... +n 
mx ct Cl cC2 Cn 


wobei MX die Pufferlänge (in HEX- maximal 255 Bytes) angibt, ET 
enthält nach Rückkehr der Funktion die Anzahl der wirklich 
eingegebenen Zeichen, während Cl..CN die eingegebenen Zeichen 
sind. CR und LF werden nicht in den Puffer übernommen. 


Bei der Eingabe werden folgende Steuerzeichen erkannt: 


CNTRL-A bewegt den Cursor ein Zeichen nach links bis zum '>', 
ohne das entsprechende Zeichen zu löschen, 


CNTRL-B bewegt den Cursor an die Position direkt nach dem '>', 
ohne den Text zu verändern. Ist der Cursor bereits an 
dieser Stelle, wird er zum Textende bewegt. 


CNTRL-C Veranlaßt einen Warmstart, wenn es als erstes Zeichen 
eingegeben wird. 


CNTRL-E erzwingt ein CR ohne dabei die Befehlszeile logisch 
abzuschliessen. Dies ist von Bedeutung, wenn man lange 
Befehlssequenzen eingeben muß, aber eine bessere Über- 
sicht auf dem Bildschirm behalten möchte. 


CNTRL-F bewegt den Cursor ein Zeichen nach rechts, ohne das 
entsprechende Zeichen zu löschen. 


CNTRL-G löscht das Zeichen unter dem Cursor und rückt den Text 
rechts davon nach links auf, der Cursor bleibt jedoch 
an seiner augenblicklichen Position. 


CNTRL-H oder BS (backspace) löscht ein Zeichen und bewegt den 
Cursor eine Position nach links. Die gleiche Funktion 
ist u.U. auch mit der DEL(ete)-Taste möglich. Dies ist 
abhängig davon, ob dies mit GENCPM entsprechend 
deklariert wurde. 


CNTRL-I oder TAB, bewegt den Cursor um eine TAB-Position nach 
rechts. TAB-Position ist jede 8. Spalte. 


CNTRL-J oder LF (linefeed) signalisiert das Befehlsende. Es 
hat den gleichen Effekt wie CNTRL-M. Dieses Zeichen 
kann an jeder beliebigen Cursorposition eingeben wer- 
den und veranlaßt dann die Abarbeitung des kompletten 
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Befehls in der Befehlszeile, D.h. auch der Text hinter 
diesem Zeichen wird abgearbeitet. 


CNTRL-K löscht die Restzeile ab der Cursorposition, 

CNTRL-M oder CR siehe CNTRL-J. 

CNTRL-R schreibt den bisher editierte Text (der besseren Über- 
sicht halber) mit allen vorgenommenen Korrekturen 
noch einmal. 

CNTRL-U löscht den Zeileninhalt und rückt eine Zeile tiefer. 

CNTRL-W bringt die 'alte' Befehlszeile zurück in den zZeilen- 
puffer zum Editieren. So können von CP/M reklamierte 
Fehleingaben einfach korrigiert werden. 


CNTRL-X löscht die Befehlszeile und setzt den Cursor direkt 
nach dem '>', 


Dem Benutzer stehen, falls diese Funktion aufgerufen wird, alle 
Vorteile des in CP/M 3 eingebauten Zeileneditors zur Verfügung, 


Anmerkung: 


Unter CP/M 2 ist nur ein Teil der genannten Kontroll-Sequenzen 
funktionsfähig. Wird versucht die entsprechende Sequenzen doch zu 
benutzen, wird das CNTRL-Zeichen mit vorangestelltem Auf- 
wärtspfeil (z.B. “W ) ausgegeben. 


+=-------- ----- --------- 22-222 nn + 
I Funktion 11 Konsolen-Status l 
DEE EEE EEE EEERENEDERERE EG EREES N NEEEREEENEREREEEEEEEEEEEEREEEE 2 + 
I Eingabe C=0BH l 
I Zurück A=00 oder OlH l 
4+=----------- 2-22 2 nn + 


Diese Funktion gibt den Status der Eingabe-Konsole zurück. 


Liegt eine Eingabe vor, dann ist Register A=0lH. Liegt keine 
Eingabe vor, dann ist Register A=00. 


Mit Funktion 109 (nur unter CP/M 3) kann die Statusabfrage in 
soweit geändert werden, daß nur nach Eingabe von CNTRL-C das Re- 
gister A=01H zurückgibt. 


Anmerkung: 

Diese Funktion ist nicht CP/M 2 kompatibel, dort wird bei Vor- 
liegen eines Zeichens (beliebiger Art) in Register A=FF zuückge- 
geben. 

Die Abfrage sollte hier in jedem Falle nach A=00 oder Bit 0=1 


erfolgen, keinesfalls auf A=FF wenn die Funktion unter CP/M 2 und 
CP/M 3 benutzt werden soll. 
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ı Funktion 12 Versionsnummer l 


}EPsmnnnnnnnnnnnnnnnnn nn nn ._. ._nnnnnnnnnnn nn nn # 


I Eingabe C=0CH l 
I Zurück HL=Versionsnummer l 
4--- .--- nn -+ 


Diese Funktion gibt die (CP/M)-Versionsnummer zurück. 


Es wird ein 2-Byte-Wert im Doppelregister <HL> zurückgegeben, 
wobei H=00 ist (für CP/M im Unterschied zu MP/M) und L=31H (oder 
größer). 


4-------- + 
I Funktion 13 Reset Diskettensystem l 
4--------------- + 
I Eingabe C=0DH N 
4--------------- + 


Diese Funktion setzt alle Diskettenparameter zurück (Siehe auch 
Funktionen 28 und 29). 


Als Vorgabelaufwerk wird Laufwerk A angesprochen und als Vorgabe- 
DMA-Adresse wird Adresse 80H gesetzt. Mit dieser Funktion kann 
der gleiche Zustand erreicht werden, wie er direkt nach dem 
Booten herrscht. 


Die Datei PROFILE.SUB wird jedoch nach diesem Software-Reset 
nicht aufgerufen, ebensowenig wie der CCP. 


+------------------ + 
I Funktion 14 Ansprechen eines Laufwerkes l 
4=-------------- + 
I Eingabe C=0EH l 
ı E=Laufwerksnummer ı 
I zurück A=Fehlerflag ! 
ı H=physikalische Fehlernummer \ 
4=------------ + 


Diese Funktion versucht das in Register <E> angegebene Laufwerk 
anzusprechen. 


Die Laufwerknummer entspricht einer HEX-Zahl von 00=A, O01=B, 02=C 
usw. Es können maximal 16 Laufwerke angesprochen werden, 


Bei Rückkehr der Funktion ist Register A=0, wenn das Laufwerk 
logisch und physikalisch vorhanden ist. Es kann hierzu notwendig 
sein, daß auch eine Diskette im Laufwerk steckt und die Klappe 
geschlossen ist. 


Im Fehlerfalle ist Register A=sFF. In diesem Falle sind nähere 
Angaben in Register H zu finden, 


Ist H=01 kann auf das Laufwerk nicht physikalisch zugegriffen 
werden. Es kann sich hierbei um eine fehlende oder falsche Disk- 
ette handeln. 

Ist H=04 ist das Laufwerk logisch nicht vorhanden, d.h. es ist im 
BIOS gar nicht eingebunden (vorgesehen). 


103 


+ 
ı 
.--------- + 
I Eingabe C=0FH l 
ı DE=FCB-Adresse ı 
I Zurück A=Fehlercode ı 
ı H=Fehlernummer ı 

+ 


Diese Funktion aktiviert den FCB einer Datei, die im Inhaltsver- 
zeichnis bereits unter dem angesprochenen Laufwerk und der gülti- 
gen USER-Ebene vorhanden ist, 


In Byte 0 des FCB wird die Laufwerkangabe erwartet, gefolgt von 
Dateiname und Index. Byte 12 des FCB gibt einen möglichen EXtend 
an, wird jedoch normalerweise auf 0 gesetzt. 


Wenn die Datei durch ein Paßwort im Lesemodus geschützt ist, muß 
dieses Paßwort in die ersten 8 Bytes der momentan gültigen DMA 
geschrieben werden, oder das Paßwort muß vorher als "default'- 
Paßwort gesetzt worden sein. (Siehe hierzu den SET-Befehl). 


wird im FCB das CR-Feld auf FF gesetzt, gibt die Funktion im CR- 
Feld den Bytezähler für den letzten (logischen) Sektor zurück. 
(Siehe Funktion 30 hierzu). 


Wird eine Datei sequentiell gelesen oder geschrieben, muß das CR- 
Feld auf 00 gesetzt sein, wenn von Beginn an gelesen werden soll. 


Wird eine Datei in einer USER-Ebene eröffnet, so wird in dieser 
USER-Ebene zuerst nach der angegebenen Datei gesucht. Wird sie 
nicht gefunden, wird in USER-Ebene 0 gesucht. Ist das Attribut T2 
(SYS-Datei) gesetzt, wird die Datei zum Lesen eröffnet. Ein 
Schreibzugriff ist in diesem Falle nicht vorgesehen. 


Ist die Eröffnung der Datei erfolgreich, werden alle Daten aus 
dem FCB des Inhaltsverzeichnisses in den Benutzer-FCB kopiert. 
Gleichzeitig werden Datums- und Zeitmarken im Inhaltsverzeichnis 
eingetragen, falls dies vom Benutzer vorgesehen ist. 


War die Eröffnung erfolgreich, kehrt die Funktion mit Register 
A=00 zum Aufrufer zurück, andernfalls ist Register A=FF. 


Im Fehlerfalle meldet das Register H eine genauere Fehlerangabe: 


H=00 Datei nicht gefunden 

H=01 Lesefehler (Disk I/O) 

H=04 Ungültige Laufwerksangabe 

H=07 Ungültiges Paßwort 

H=09 Joker im Dateinamen oder Index 
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4+--------- m nn + 
I Funktion 16 schließen einer Datei ı 
4+=---------- mm + 
ı Eingabe C=10H l 
l DE=FCB-Adresse ı 
I Zurück A=sFehlercode l 
l H=Fehlernummer l 
44---------- mm nn + 


Mit dieser Funktion wird eine zuvor geöffnete, Datei wieder 
geschlossen. 


Das Schließen einer Datei bewirkt das Umgekehrte wie das Eröffnen 
einer Datei. Der FCB der zu schließenden Datei muß zuvor durch 
eine erfolgreiche Eröffnung oder Aufbau eines FCB (Funktionen 15 
oder 22) aktiviert worden sein. Beim Schließen einer Datei wird 
der FCB in das Inhaltsverzeichnis zurückgeschrieben, wenn durch 
Schreiboperationen der geöffnete FCB geändert wurde. 


Es erfolgt kein Rückschreiben in das Inhaltsverzeichnis, wenn die 
eröffnete Datei nur gelesen wurde, diese Funktion braucht in 
diesem Falle also auch nicht aufgerufen werden. 


Eine Besonderheit muß hier noch erwähnt werden. Wird Bit 7 des 5. 
Buchstabens im Dateinamen (f5') gesetzt, wird die Datei als 
zZwischendatei (temporary) markiert. Alle Dateien dieser Art 
können unter CP/M 3 mit Funktion 93 durch einen Funktionsaufruf 
wieder gelöscht werden, 


Die Funktion kehrt mit Register A=00 zurück, wenn die Datei 
einwandfrei geschlossen werden konnte. Im Fehlerfalle ist Re- 
gister A=FF und in Register H werden folgende Fehlermeldungen 
zurückgegeben: 


H=01 Lese oder Schreibfehler (Disk I/O) 

H=02 Diskette ist Schreibgeschützt 

H=04 Ungültiges Laufwerk 
4------ + 
ı Funktion 17 Suche ersten DIR-Eintrag ı 
4+-------- + 
I Eingabe C=11H l 
ı DE=FCB-Adresse l 
I Zurück A=DIR-Code ı 
l H=Fehlernummer ı 
4+=----------- mm nn + 


Mit dieser Funktion beginnt das Suchen nach einem Eintrag im In- 
haltsverzeichnis einer Diskette. 


Gesucht wird in dem im FCB angegebenen Laufwerk oder, ist dort 00 
spezifiziert, im gerade gültigen Laufwerk. Gesucht wird nach dem 
ersten Eintrag im Inhaltsverzeichnis, der sich mit dem Dateinamen 
und Index im FCB deckt. 


Im FCB können Fragezeichen als Joker verwendet werden. Auch in 
diesem Falle wird die erste Datei gesucht, die zum angegebenen 
FCB paßt. 


Anstelle eines FCB's kann <DE> auch auf ein einzelnes Frage- 
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zeichen zeigen. In diesem Falle wird der erste Eintrag des In- 
haltsverzeichnisses eingelesen, Diese Art der Suche ist not- 
wendig, falls nach dem Namen einer Diskette gesucht wird. Dieser 
ist dadurch kenntlich gemacht, daß anstelle einer Laufwerksbe- 
zeichnung (00..0FH) ein 20H eingetragen ist. 


Wird der Dateiname nicht gefunden oder tritt ein anderer Fehler 
auf, kehrt die Funktion mit Register A=FF zurück. Ist Register 
H=01 trat ein Lesefehler auf, bei Register H=04 wurde ein ungül- 
tiges Laufwerk angesprochen. 


Konnte die Datei gefunden werden, kehrt die Funktion mit Register 
A=00 bis A=03 zurück. In diesem Falle ist der Inhalt von Register 
A ein Zeiger auf den richtigen Eintrag im Inhaltsverzeichnis. 


Dies ist so zu verstehen, daß die Funktion jeweils 4 Einträge in 
die (80H große) momentane DMA einliest. Jeder Eintrag ist 32 
Bytes groß. Ist Register A=00, dann ist der erste Eintrag gültig, 
ist A=01 der Zweite usw. 


Ist das Inhaltsverzeichnis (mit INITDIR) für Datums- und Zeit- 
marken erweitert, wird der jeweils 4. Eintrag in einem Block für 
die entsprechenden Daten reserviert. Dieser 4. Eintrag beginnt 
mit 21H. In diesem Falle kehrt jedoch auch Register A nur mit 
Werten von 0..2 zurück, 


Mit diese Funktion wird auch die Funktion 18 initialisiert, mit 
der jedes weitere Suchen im Inhaltsverzeichnis fortgesetzt wird. 


+------------- + 
I Funktion 18 Suche nächsten DIR-Eintrag l 
+47--------------- nn + 
I Eingabe C=012H l 
I Zurück A=DIR-code N 
l H=Fehlernummer ı 
+7------------------- nn + 


Diese Funktion sucht nach Aufruf der Funktion 17 nach weiteren 
Einträgen im Inhaltsverzeichnis, die mit dem Namen im angegebenen 
FCB übereinstimmen, 


Der Rückgabecode entspricht dem unter Funktion 17 beschriebenen. 


+7----------------- 22 nn + 
li Funktion 19 Löschen einer Datei ı 
4+------------------ ann nn = 
I Eingabe C=12H ı 
l DE=FCB-Adresse l 
I Zurück A=Fehlercode ı 
l H=Fehlernummer ı 
4--------------- 2-2 2 + 


Mit dieser Funktion können Dateien aus dem Inhaltsverzeichnis 
gelöscht werden, 


Der Dateiname im FCB kann Fragezeichen als Joker enthalten. 
Es wird jede Datei gelöscht, die dem Namen im FCB entspricht. Es 
wird hierbei genaugenommen nicht der ganze zugehörige FCB im 
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Inhaltsverzeichnis gelöscht, sondern nur die Laufwerksbezeichnung 
durch ein E5H ersetzt. Die Datei wird dann nicht mehr im In- 
haltsverzeichnis dargestellt und der zugehörige FCB vom nächsten 
Eintrag überschrieben, 


Konnte (n) die angegebene (n) Datei(en) gelöscht werden, kehrt die 
Funktion mit Register A=00 zurück, andernfalls ist Register A=FF. 


Im Fehlerfall hat der Inhalt des H-Registers bei der Rückkehr 
folgende Bedeutung: 


H=01 Schreib-/Lesefehler (Disk-I/O) 

H=02 Diskette ist schreibgeschützt 

H=03 Datei ist schreibgeschützt (Read-Only) 

H=04 Ungültige Laufwerksangabe 

H=07 Ungültiges Paßwort 
4----------- Om m + 
I Funktion 20 sequentiell Lesen l 
4+-=------------- mm + 
I Eingabe C=14H l 
ı DE=FCB-Adresse l 
I Zurück A=Fehlercode l 
ı H=Fehlernummer ı 
4e=-=------- mm m + 


Diese Funktion liest die nächsten 1..128 logischen 128 Byte Sek- 
toren einer Datei an die gültige DMA-Adresse. 


Mit Funktion 44 kann definiert werden, wieviele logische Sektoren 
bei jedem Aufruf eingelesen werden sollen. Bei jedem Warmstart 
wird dieser Wert vom CCP auf 'l' gesetzt und ist somit CP/M 2 
kompatibel. 


Vor dem Lesen muß die Datei mit Funktion 15 erfolgreich eröffnet 
worden sein. 


Soll eine Datei von Beginn an gelesen werden, so muß das CR-Feld 
im FCB auf 0 gesetzt werden. Das CR-Feld wird vom BDOS im FCB 
mitgehalten bis die Daten des FCB's im Inhaltsverzeichnis den 
Daten im Benutzer-FCB entsprechen. (d.h. die Datei vollständig 
eingelesen wurde). 


Ist eine Datei größer als 16K wird die entsprechende EXtend-Datei 
automatisch eröffnet und aus dem "'neuen' FCB weiter gelesen. 


Kehrt die Funktion mit Register A=00 zurück, konnte ein Sektor 
fehlerfrei gelesen werden. Andernfalls werden in Register A fol- 
gende Fehler gemeldet: 


A=01 Lesen von ungeschriebenen Daten (...Dateiende) 
A=09 falscher FCB oder bereits geschlossener FCB 
A=10 Diskette wurde während des Lesens gewechselt 
A=FF hardware-Fehler 


Bei allen Fehlern (außer den Hardware-Fehlern) enthält das Re- 
gister H die Anzahl der bereits erfolgreich gelesenen logischen 
Sektoren. 
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Wurde ein Hardware-Fehler gemeldet, enthält das Register H nähere 
Angaben: 


H=01 Lesefehler (Disk-I/O) 

H=04 Ungültiges Laufwerk 
+------------ - ---------- + 
I Funktion 21 sequentiell Schreiben ı 
4=-------- + 
I Eingabe C=15H l 
l DE=FCB-Adresse I 
I Zurück A=Fehlercode ı 
| H=Fehlernummer l 
47--------- + 


Diese Funktion schreibt die nächsten 1..128 logische 128 Byte 
Sektoren einer Datei beginnend bei der momentanen DMA-Adresse auf 
Diskette, 


Mit Funktion 44 kann gesetzt werden, wieviele logische Sektoren 
mit einem Aufruf geschrieben werden sollen. Bei jedem Warmstart 
wird dieser Wert vom CCP auf 'l' zurückgesetzt, damit die 
Funktion CP/M 2 kompatibel ist. 


Vor dem Schreiben muß der FCB mit Funktion 15 oder 22 erfolgreich 
eröffnet worden sein. Nach dem Eröffnen muß das CR-Feld auf 00 
zurückgesetzt werden, wenn von Dateibeginn an geschrieben werden 
soll. 


Die Funktion eröffnet von sich bei Dateien von über 16k Größe 
weiter FCB's, 


Die Funktion kehrt mit Register A=00 zurück, wenn er£nrlgreich 
geschrieben werden konnte. Im Fehlerfall enthält Register A fol- 
genden Fehlercode: 


A=01l Inhaltsverzeichnis voll 

A=02 Diskette voll 

A=09 Falscher FCB oder bereits geschlossener FCB 
A=10 Diskettenwechsel während des Schreibens 
A=FF Hardware-Fehler 


Bei allen Fehlermeldungen außer bei hardware-Fehler, enthält 
Register H die Anzahl der bereits geschriebenen logischen Sekto- 
ren. 


Bei Hardware-Fehler enthält das Register H folgenden Fehlercode: 


H=01 Schreibfehler (Disk I/O) 
H=02 Diskette ist Schreibgeschützt 
H=03 Datei ist Schreibgeschützt (Read-Only) 


oder Datei in USER-Ebene 0 aus einer anderen 

USER-Ebene eröffnet 

oder Datei Paßwortgeschützt beim Schreiben 
H=04 Ungültiges Laufwerk 
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4e-- nn nn .m————. .— .—nnnnnn nn + 


li Funktion 22 Eröffnen eines DIR-Eintrages ı 
4+----- .un nn nn nn ._--- + 
I Eingabe C=16H l 
ı DE=FCB-Adresse ı 
I zurück A=Fehlercode l 
l H=Fehlernummer ı 
4=---- . nn . nn + 


Diese Funktion wird aufgerufen, wenn eine neue Datei erstellt 
werden muß, die noch nicht im Inhaltsverzeichnis aufgeführt ist. 


Die Auswirkung dieser Funktion entspricht im Übrigen allem, was 
zu Funktion 15 gesagt wurde, incl. den möglichen Fehlermeldungen. 


4-=------------ + 
I Funktion 23 Umbenennen einer Datei ı 
4------ um nn nn + 
ı Eingabe C=17H ı 
l DE=FCB-Adresse l 
I Zurück A=Fehlercode I 
l H=Fehlernummer l 
4=----------- nn + 


Mit dieser Funktion können Dateien umbenannt werden. 


Der FCB dieser Funktion muß in den ersten 16 Bytes den alten 
Dateinamen enthalten (wie in allen FCB's gewohnt). In den zweiten 
16 Bytes dieses FCB's muß dann, im gleichen Format, der neue 
Namen der Datei stehen. In diesem Falle sind keine Fragezeichen 
als Joker zugelassen. 


Ist die umzubenennende Datei durch ein Paßwort geschützt, muß das 
richtige Paßwort in die ersten 8 Bytes der gültigen DMA ge- 
schrieben werden. 


Das DR-Feld im FCB wird zur Auswahl des betroffenen Laufwerkes 
herangezogen. 


Wurde die Umbenennung erfolgreich durchgeführt, kehrt die Funk- 
tion mit Register A=00 zurück. 


Im Fehlerfalle ist Register A=FF und Register H enthält folgenden 
Fehlercode: 


H=01 Schreib/Lesefehler (Disk I/O) 
H=02 Diskette schreibgeschützt 
H=03 Datei schreibgeschützt 

H=04 Ungültiges Laufwerk 

H=07 Ungültiges Paßwort 

H=08 Dateiname bereits vorhanden 
H=09 Joker (?) im Dateinamen 
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Il Funktion 24 Lese Login Vektor l 
4=---------- + 
I Eingabe C=18H l 
I Zurück HL=Login Vektor l 
4=------- --------------- 22 + 


Diese Funktion bringt im Doppelregister <HL> einen Wert zurück, 
der die eingeloggten (nach dem Booten oder CNTRL-C zumindest 
einmal benutzten) Laufwerke repräsentiert. 


Bit 0 des übergebenen 16 Bitwortes entspricht dabei Laufwerk A 
und Bit 15 Laufwerk P. 


Ein Laufwerk ist aktiviert, wenn das entsprechende Bit gleich 1 
ist, deaktiviert (nicht eingeloggt), wenn das entsprechende Bit 0 
ist. 


Zur Kompatibilität mit früheren Versionen von CP/M enthält Re- 
gister A den gleichen Wert wie Register L. 


+------------- ------ + 
I Funktion 25 monentanes Laufwerk l 
+------------ ------ + 
I Eingabe C=19H l 
I Zurück A=momentanes Laufwerk ı 
4=------------ + 


Diese Funktion stellt fest, welches Laufwerk zuletzt aktiviert 
war. 


Der entsprechende Code wird in Register A zurückgegeben mit 00=A, 
Ol=B, 02=C usw. 


4------------- + 
I Funktion 26 Setzten der DMA-Adresse l 
4-------------- + 
l Eingabe C=1AH l 
L DE=DMA-Adresse ı 
4=---------------- + 


Diese Funktion setzt die Adresse der DMA,. 


DMA ist die CP/M-typische Abkürzung für Direct Memory Address im 
Sinne von Direkter Speicher Adresse. Die DMA ist üblicherweise 
ein Puffer, aus welchem gelesen oder in welchen geschrieben 
werden kann. 


Die Größe des Puffers kann mit Funktion 44 gesetzt werden. Bei 
jedem Rücksprung in den CCP wird von diesem die Puffergröße 
automatisch auf 128 Bytes gesetzt, um mit CP/M 2 kompatibel zu 
bleiben. (Ein logischer 128 Byte Sektor). Solange der CCP aktiv 
ist oder SID und Co., ist die DMA fest auf Adresse 80H einge- 
stellt. 


Die DMA-Adresse wird nicht NUR zum Lesen oder Schreiben von 
Dateien benötigt, vielmehr erwarten oder übergeben einige Funk- 
tionen im DMA-Puffer ihre Daten. 


Wurde eine DMA-Adresse neu gesetzt, so behält sie ihren Wert bis 
eine neuer Funktionsaufruf ihn ändert. 


Mit Funktion 49 ist es möglich die gerade gültige DMA-Adresse 
festzustellen, falls dies in einem Programm wichtig sein sollte. 


Anmerkung: 
Die Bezeichnung DMA sollte auf keinen Fall mit der gleichlauten- 


den Bezeichnung für entsprechende Hardware-Bauteile verwechselt 
werden. 


4e=--- nn nn + 
I Funktion 27 hole Belegungsvektor (Allocation) | 
44-0 + 
I Eingabe C=1BH l 
I Zurück HL=Vektor-Adresse l 
4e------- + 


Diese Funktion übergibt einen Zeiger auf die Belegungsvektoren. 


Diese Funktion ist unter CP/M 3 nur noch bedingt verwendbar, da 
im gebankten System der Vektor in Bank 0 liegen kann und sich so 
dem Zugriff aus der TPA heraus verschließt. 


Aus dem Belegungsvektor kann errechnet werden, inwieweit eine 
Diskette bereits belegt ist bzw. wieviel freier Speicherplatz auf 
ihr noch zur Verfügung steht. 


Wurde (mit GENCPM) der Vektor im gemeinsamen Speicherbereich 
belassen kann die Funktion weiter benutzt werden. In jedem Falle 
wird die Adresse des Vektors in Register HL zurückgegeben, 


Im Fehlerfalle übergibt das Doppelregister <HL> den Wert FFFF. 


Soll die Restkapazität unter CP/M 3 festgestellt werden, kann 
hierzu Funktion 46 verwendet werden. 


Anmerkung: 


Bei Anwendung dieser Funktion in CP/M 2 Programmen unter CP/M 3 
können hier Fehlangaben bzgl. des verbleibenden Speicherplatzes 
auftreten. Eine einfache Lösung des Problemes ist nicht so ohne 
weiters möglich. Denkbar wäre es, mit Funktion 46 die Restkapa- 
zität festzustellen und über einen RSX einen "eigenen' Vektor 
aufzubauen, dessen Adresse an den Funktionsaufrufer zurückgegeben 
wird. 


4e-------------- mn + 
li Funktion 28 Schreibschutz einschalten I 
44+----------- mn + 
I Eingabe C=1CH l 
4+=---2------ + 


Mit dieser Funktion wird das zuletzt aktive Laufwerk software- 
mäßig mit einem Schreibschutz versehen. 


Jeder Schreibzugriff auf dieses Laufwerk wird verwehrt, bis ent- 
weder Funktion 13 oder 37 aufgerufen wurde. 


111 


I Funktion 29 Schreibschutz feststellen l 
4+=-=---------- 0 + 
I Eingabe C=1DH ı 
I Zurück HL=Schreibschutzvektor l 
4+------- 000 + 


Mit dieser Funktion kann festgestellt werden, welche Laufwerke 
mit Funktion 28 schreibgeschützt wurden. 


Die Information wird in einem 16 Bit-Wort in Register HL zurück- 
gegeben. Bit 0 entspricht Laufwerk A, Bit 1 Laufwerk B usw. Ist 
das entsprechende Bit=1, dann ist das Laufwerk schreibgeschützt, 
ist es 0, dann kann das Laufwerk beschrieben werden. 


Diese Funktion kann NICHT feststellen, ob eine Diskette hardware- 
mäßig schreibgeschützt ist. 


4=----------- + 
! Funktion 30 Setzen von Dateiattributen ı 
4=------------- + 
! Eingabe C=1EH ! 
[| DE=FCB-Adresse l 
I zurück A=Fehlercode ı 
l H=Fehlernummer l 
4=------------- + 


Mit Aufruf dieser Funktion kann ein Programm die Datei-Attribute 
setzten oder ändern. 


Dies ist nur mit dieser Funktion möglich. Es ist nicht durch 
einfaches Ändern des FCB's beim Schreiben oder Lesen mögl'’ch. 


Die Attribute (Bit 7 gesetzt=EIN zurückgesetzt=AUS) Fl bis F4 und 
Tl bis T3 müssen im FCB entsprechend gesetzt sein, wenn diese 
Funktion aufgerufen wird. Joker in Dateinamen sind nicht zugelas- 
sen. 


Falls die aufzurufende Datei mit einem Paßwort versehen ist, muß 
dieses in die ersten 8 Speicherstellen der gültigen DMA ge- 
schrieben werden oder der 'default'-Modus muß eingeschaltet sein. 


Die Funktion sucht im Inhaltsverzeichnis der vorgegebenen USER- 
Ebene und dem im DR-Feld angegebenene Laufwerk nach einer Datei 
mit dem entsprechenden Namen. Wird die Datei gefunden, werden die 
Attribute angepaßt und die Funktion kehrt mit Register A=00 
zurück. 


Im Fehlerfalle ist Register A=FF. Eine nähere Fehlerbezeichnung 
wird in Register H mit folgender Bedeutung übergeben: 


H=00 Datei nicht gefunden 

H=01 Schreib/Lesefehler (Disk I/O) 
H=02 Diskette ist schreibgeschützt 
H=04 ungültiges Laufwerk 

H=07 ungültiges Paßwort 

H=09 Joker (?) im Dateiname 
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desmanansnnossnnnnm „.a_—m—nunmnunnnnnnne ._——nnnnnnn + 


li Funktion 31 hole DPB-Adresse ı 
deemmmmanmmmmmmue .._—mnnnnnnnnn „m anmunmnunm -._—— ._ + 
I Eingabe C=1FH l 
I Zurück HL=DPB-Adresse l 


4esmannnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnmnnnnnnnnnnmne + 


Mit dieser Funktion wird die Adresse des DPB (Disketten Parameter 
Block) des zuletzt aktiven Laufwerkes übergeben. 


Aus dem DPB können die wichtigsten Disketten-Parameter übernommen 
werden. Näheres hierzu in Teil IV. 


Im Fehlerfalle (siehe Funktion 45) übergibt das Doppelregister 
<HL> den Wert FFFF, 


Der DPB liegt unter CP/M 3 im gemeinsamen Speicherbereich, auf 
welchen auch aus der TPA heraus zugegriffen werden kann. 


4 nn + 
li Funktion 32 setzen/lese USER-Nummer l 
4+=-------------- + 
li Eingabe C=20H ! 
l E=FFH (lesen) oder USER-Nummer l 
I Zurück A=USER-Nummer oder Ungültig l 
I|------ nn nn nn nn nn nn nn + 


Diese Funktion ermöglicht es, aus einem Programm heraus die USER- 
Ebene umzuschalten. 


Die USER-Nummer wird in HEX(adezimal, 00..0FH) in Register <E> 
übergeben. 


Wird Register <E> beim Aufruf auf FFH gesetzt, wird die momentane 
USER-Nummer gelesen und in Register A zurückgeben. 


Wenn ein Aufruf mit Register E=USER-Nummer erfolgt, ist bei der 
Rückkehr der Funktion der Inhalt des Registers A ungültig. 


deze mm 4 
li Funktion 33 Wahlfreier Lesezugriff l 
4+------------ nn + 
ı Eingabe C=21H ı 
ı DE=FCB-Adresse ı 
I Zurück A=Fehlercode ı 
l H=Fehlernummer l 
4+--------- nn ._.------ nn nn + 


Mit dieser Funktion können einzelne Sektoren einer Datei wahlfrei 
gelesen werden. 


Der wahlfreie Lesezugriff ist ähnlich dem sequentiellen Lesen. 
Der Lesezugriff wird jedoch über einen 24-Bit Wert in rO0,rl und 
r2 des FCB's gesteuert, der den Offset (in logischen Sektoren) 
vom Beginn der ersten Datei an angibt. 


Die genannten Zeiger werden an einen normalen FCB als Byte 33,34 


und 35 angehängt. Die Werte werden mit rO0 als unterstes Byte, rl 
als mittleres Byte und r3 als höchstes Byte abgelegt. 
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Es können max. 262143 Sektoren in einem DIR-Eintrag abgelegt 
werden, 


Um eine Datei mit dieser Funktion zu lesen, muß zuerst der zuge- 
hörige FCB mit einem EX von O0 eröffnet werden. Hierdurch wird der 
FCB vom BDOS korrekt initialisiert. Die Funktion liest danach für 
jeden Aufruf den im RC-Feld angegebenen Sektor in den vorgegebe- 
nen DMA-Puffer. 


Im Gegensatz zum sequentiellen Lesen wird der EX(tend) jedoch 
nicht inkrementiert, dies muß vom Programm übernommen werden, 


Wurde mit Funktion 44 ein Mehrfachzugriff zugelassen, so wird die 
dort vorgegebene Anzahl von logischen Sektoren gelesen. 


Konnte fehlerfrei gelesen werden, wird Register A=00 zurückge- 
geben. Andernfalls meldet Register A folgende Fehler: 


A=01 Dateiende 

A=03 der momentane Ext. kann nicht geschlossen werden 
A=04 der gewünschte Extend wurde nicht beschrieben 
A=06 Sektornummer zu groß (über 262143) 

A=10 Diskette wurde gewechselt 

A=FF physikalscher Fehler 


Wird ein physikalischer Fehler gemeldet, sind nähere Angaben aus 
Register H zu entnehmen: 


H=01 Lesefehler (Disk I/O) 
H=04 ungültiges Laufwerk 


Handelt es sich nicht um einen physikalischen Fehler, wird in 
Register H die Anzahl der mit Funktion 44 vorgegebenen Sektoren 
angegeben, die mit dem momentanen Funktionsaufruf bereits gelesen 
wurden. Ist Funktion 44 mit ]l gesetzt, bleibt H immer auf 00H. 


+-------------------- + 
Il Funktion 34 Wahlfreier Schreibzugriff ı 
4--------- -- - ------ = nn + 
I Eingabe C=22H l 
I DE=FCB-Adresse \ 
I Zurück A=Fehlercode I 
I H=Fehlernummer l 
+4------------ 2... + 


Mit dieser Funktion können einzelne Sektoren einer Datei wahlfrei 
beschrieben werder. 


Das wahlfreie Schreiben ist das Gegenstück zum wahlfreien Lesen. 
Hier werden die Daten auf die Diskette geschrieben. 


Das BDOS übernimmt automatisch die Belegungszuweisung im gültigen 
FCB, der zuvor mit Funktion 15 oder 22 eröffnet werden muß. 
Hierbei muß ebenfalls der EXtend auf 0 gesetzt werden, um eine 
korrekte Initialisierung zu Gewährleisten,. 


Ist der FCB noch leer (wurden noch keinerlei Daten geschrieben), 
muß Funktion 22 zur Eröffnung aufgerufen werden. 
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Sind Datums- und Zeitmarken aktiviert, werden diese automatisch 
eingetragen. 


Mit Funktion 44 kann das Schreiben von mehreren logischen Sek- 
toren bei einem Funktionsaufruf erzwungen werden, 


Konnte fehlerfrei geschrieben werden, kehrt die Funktion mit 
Register A=00 zurück. Andernfalls meldet der Inhalt von Register 
A folgende Fehler: 


A=02 Es steht kein Datenblock mehr zur Verfügung 

A=03 Der momentane EXtend kann nicht geschlossen werden 
A=05 Inhaltsverzeichnis voll 

A=06 Sektornummer zu groß 

A=10 Diskettenwechsel während des Schreibens 

A=FF physikalischer Fehler 


Tritt ein Paralkal Ieeber Fehler auf, werden nähere Angaben in 
Register H mit folgender Bedeutung übergeben: 


H=01 Schreibfehler (Disk-I/O) 

H=02 Diskette ist schreibgeschützt 

H=03 Datei ist schreibgeschützt oder USER-Ebene falsch 

H=04 ungültiges Laufwerk 
4m nn + 
I Funktion 35 Berechne Dateigröße l 
4+-------------- mn + 
I Eingabe C=23H l 
l DE=FCB-Adresse ı 
I Zurück A=Fehlercode I 
l H=Fehlernummer l 
l r0..r2-Feld gesetzt l 
4+--------- + 


Dies Funktion berechnet die Dateigröße der im FCB angegebenen 


Genaugenommen wird als Ergebnis die Adresse des Sektors angege- 
ben, der dem letzten Sektor der angegebenen Datei folgt. 


Zur Anwendung dieser Funktion müssen im FCB die Bytes r0..r2 
(Bytes 33 bis 35) reserviert sein. Diese Bytes werden nach Aufruf 
der Funktion auf die letzte Sektornummer (+1), die von der Datei 
belegt wurde, gesetzt. 


Ist Byte r2=04H, dann ist die maximal mögliche Anzahl wahlfreier 
Sektoren erreicht. (262144). 


Ein Programm kann an eine vorhandene Datei Daten anhängen, wenn 
vor dem Schreiben der neue Sektorzähler mit dieser Funktion 
gesetzt wurde. 


Es ist nicht notwendig, daß beim Aufruf dieser Funktion die 
entsprechende Datei bereits eröffnet wurde. Sie muß auf alle 
Fälle jedoch vor einem Aufruf geschlossen worden sein, da sonst 
falsche Daten übergeben werden können. 
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Wurde die Funktion fehlerfrei beendet, wird Register A=00 zurück 
gegeben und die Bytes r0..r2 im FCB enthalten die gewünschten 
Daten. Andernfalls enthält Register A=FF. 


Nähere Fehlermeldungen bei Hardware-Fehler werden in Register H 
mit folgender Bedeutung übergeben: 


H=01 Lesefehler (Disk-I/O) 

H=04 ungültiges Laufwerk 
+7------------ + 
I Funktion 36 Setze wahlfreien Sektor ı 
47-------------------- 00 + 
Il Eingabe C=24H ı 
v DE=FCB-Adresse l 
I zurück r0..r2 gesetzt ı 
+2------------ 00 + 


Mit dieser Funktion wird der Sektor festgelegt, auf den mit der 
nächsten Funktion wahlfrei (direkt) zugegriffen werden soll. 


Diese Funktion kann benutzt werden, wenn eine Datei bis zu einem 
gewissen Punkt (mit Funktion 20 bzw. 21) gelesen oder beschrieben 
wurde und auf weitere Daten nun wahlfrei zugegriffen werden soll. 


Die Funktion setzt die Bytes r0..r2 entsprechend der belegten 
Sektornummer. 


Der FCB muß vor Aufruf der Funktion erfolgreich eröffnet worden 
sein. 


Fehler sind mit dieser Funktion nicht zu erwarten, 


+-------------------- 2 ann + 
I Funktion 37 Laufwerk zurücksetzen l 
4--=--2-0-----2----- -2n nn nn nn nn nn + 
I Eingabe C=25H ı 
l DE=Laufwerksvektor 

I Zurück A=00 N 
+22 ------------ 2 nn + 


Diese Funktion setzt alle angegebenen Laufwerke in den RESET- 
Zustand zurück. 


Dies bedeutet, daß beim nächsten Aufruf eines zurückgesetzten 
Laufwerkes vom BDOS zuerst ein erneuter Login veranlaßt wird (Ein 
erneutes Einstellen aller Diskettenparameter). 


Der Laufwerksvektor ist ein 16-Bit Wort mit Bit O=Laufwerk A und 
Bit 15=Laufwerk P. Ein Laufwerk wird zurückgesetzt, wenn das 
entsprechende Bit im Vektor auf 1 gesetzt wird. Ist das ent- 
ne Bit=0, bleibt das Laufwerk in seinem bisherigen Zu- 
stand. 
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I Funktion 38 auf Laufwerk zugreifen l 
4 oo nn En 
I Eingabe C=26H l 
I Zurück A=00H unter CP/M 3 l 
44------- nt 


4------------- nn + 
I Funktion 39 Laufwerk freigeben l 
4e-------- mm + 
li Eingabe C=27H I 
I zurück A=00H unter CP/M 3 l 
4e-------- mn + 


4--------- + 
I Funktion 40 wahlfreies Schreiben mit l 
| Auffüllen von 00H L 
4+-------------- + 
ı Eingabe C=28H ! 
l DE=FCB-Adresse I 
I Zurück A=Fehlercode ! 
l H=Fehlernummer 1 
4----------- + 


Diese Funktion entspricht in allem der Funktion 34 (wahlfreies 
Schreiben), mit der Ausnahme, daß alle Sektoren vor dem Be- 
schreiben mit 00H (überschrieben) gelöscht werden, 
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Kapitel 3 Die CP/M 3 typischen Funktionen 


Werden Programme geschrieben, die auch unter CP/M 2 funktionieren 
sollen, können die nachfolgenden Funktionen (leider) nicht aufge- 
rufen werden. 


Um unliebsame Effekte beim CP/M 2 Benutzer zu vermeiden, falls er 
doch Programme dieser Art in die Hand bekommt, sollten alle 
Programme die Funktionsaufrufe aus diesem Kapitel benutzen, immer 
zuerst über Funktion 12 die Versionsnummer abfragen und bei 
Inkompatibilität das Programm mit einer Fehlermeldung abbrechen, 


Es sei bei dieser Gelegenheit auch auf die Nichtverwendbarkeit 
von Funktion 7 und 8 unter CP/M 2 hingewiesen; auch Funktion 30 
kann zu unliebsamen Störungen führen. 


Die nachfolgend aufgelisteten Funktionen haben nicht mehr unbe- 
dingt aufeinanderfolgende Funktionsnummern. Es steht zu vermuten, 
daß sich Digital Research die fehlenden Funktionsnummern für 
Erweiterungen in 16-Bit CP/M Systemen reserviert hat. 


werden Funktionen, die nicht angegeben sind, aufgerufen, kehren 
sie ohne "'murren' zurück. 
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4+-- kun nn nn ..----- nn + 


li Funktion 41 Testen und Schreiben eines Sektors | 
4--------- ._-- mm nn .--- nn + 
ı Eingabe C=29H ı 
I DE=FCB-Adresse ı 
I Zurück A=Fehlercode l 
ı H=Fehlernummer ı 
4+--------- ._u_nnnn nn ._-- + 


Dies ist eine unter CP/M 3 nicht unterstützte MP/M-Funktion, 


Wird sie unter CP/M aufgerufen kehrt die Funktion mit Register 
A=FF und Register H=00 zurück. 


4-=-=------ ._-- nn + 
li Funktion 42 Datei sichern ! 
4-------- mm + 
I Eingabe C=2AH l 
ı DE=FCB-Adresse | 
I Zurück A=00H l 
4#-------- en nn + 


4e----- an m + 
ı Funktion 43 Datei entsichern ı 
== een ann an nn + 
I Eingabe C=2BH ! 
ı DE=FCB-Adresse ı 
I Zurück A=00H ı 
+------------ on nn m + 


Dies ist eine unter CP/M 3 nicht unterstützte MP/M-Funktion. 


Die nachfolgenden Funktionsbeschreibungen beginnen alle am Anfang 
einer neuen Seite um eine bessere Übersicht zu erhalten. 
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Il Funktion 44 Vielfach-Sektor Zähler setzen I 
4=----- ------ --- .-- --------- + 
I Eingabe C=2CH l 
l E=Sektor-Zähler l 
I Zurück A=Fehlercode N 
4=--------------- + 


Mit dieser Funktion wird ein Zähler gesetzt, der die Anzahl der 
mit einem Funktionsaufruf zu bearbeitenden logischen Sektoren 
angibt. 


Unter CP/M werden normalerweise nur logische Sektoren mit jeweils 
128 Bytes mit einem Schreib- oder Lesevorgang bearbeitet. Auch 
der Puffer in der Standard-DMA auf Adresse 80H ist nur so groß, 
daß ein logischer Sektor gerade "hinein paßt', 


Unter CP/M 3 ist es nun möglich, beim Schreiben und Lesen von 
Dateien die behandelte Sektorgröße auf ein Vielfaches der log- 
ischen Sektorgröße festzulegen. Es sind Faktoren von 1...128 
möglich, 


Die neu gesetzte Sektorgröße bleibt solange erhalten, bis sie von 
einem erneuten Aufruf der Funktion geändert wird. 


Es ist jedoch immer zu beachten, daß der CCP bei jedem Warmstart 
die Sektor-Größe wieder auf 1 zurücksetzt, um evtl, Schwierig- 
keiten mit dem Standard-Puffer sicher zu umgehen, falls CP/M 2- 
Programme aufgerufen werden. 


Diese Funktion kehrt nach Aufruf mit Register A=00 zurück, wenn 
der neue Sektorzähler im Bereich von 1..128 gesetzt wurde. Werden 
andere Bereiche angegeben, wird der Befehl ignoriert und das 
Register A kehrt mit A=FF zurück. 
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li Funktion 45 Setze BDOS Fehlermodus L 
4+--------- m nn + 
I Eingabe C=2DH l 
l E=Fehlermodus I 
}e=--n-snnnnnnnnnnn nn nn ._nnnnnn .u_unnnnnnnnnnnnnnn + 


Diese Funktion definiert die Art der Fehlermeldung des BDOS. 
Es sind drei Modi möglich: 
E=FFH 


Fehler werden nur in den für einen Funktionsaufruf vorgesehenen 
Registern zurückgemeldet 


E=FEH 

Fehler werden in den für den Funktionsaufruf vorgesehenen Re- 
gistern zurückgemeldet und darüberhinaus noch auf der Konsole als 
Klartext wie im BIOS vorgesehen. 

E= 

jede beliebige andere Eingabe veranlaßt die Art der Fehlermeldung 


wie sie bei der Systemgenerierung mit GENCPM festgelegt wurde. 
zusätzlich wird der Abbruch des Programmes veranlasst. 
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4+=--------------- + 
ıi Funktion 46 lese restlichen Speicherplatz ı 
4+--=----------- + 
I Eingabe C=2EH N 
l E=Laufwerksnummer l 
I Zurück A=Fehlercode l 
l H=Fehlernummer I 
1 DMA=Daten ! 
4+=----------- + 


Mit dieser Funktion kann die restliche (unbelegte) Speichergröße 
einer Diskette abgefragt werden, 


Die Angabe erfolgt als Anzahl der verbleibenden logischen (128- 
Byte) Sektoren. 


Die Laufwerksangabe wird in HEX-Werten verlangt, wobei A=00, B=01 
usw. entspricht. 


Ist bei der Rückkehr der Funktion das Register A=00, konnte die 
Funktion einwandfrei ausgeführt werden. In diesem Falle stehen 
die gesuchten Werte in den ersten 3 Bytes der momentanen DMA- 
Adresse, wobei DMA+0O der untere Wert, DMA+l der mittlere und 
DMA+2 der obere Wert ist. 


Im Fehlerfalle kehrt das Register A=FF zurück, nähere Fehleran- 
gaben befinden sich dann in Register H mit folgender Bedeutung: 


H=01 Lesefehler (Disk I/O) 
H=04 ungültiges Laufwerk 
Achtung: 


Wenn das Laufwerk schreibgeschützt ist, kann der von Funktion 46 
zurückgegebene Wert fehlerhaft sein! 
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li Funktion 47 Programm übergeben l 
4a nn nn + 
ı Eingabe C=2FH l 
ı E=Flag | 
de--------- An nm nn nn + 


Diese Funktion ermöglicht es, aus einem Programm heraus nach 
dessen Abschluß, ohne Eingriff des Benutzers, ein weiteres Pro- 
gramm anzuhängen. 


Hierzu ist es notwendig, in die derzeitige DMA den nächsten 
Programmaufruf als Befehl, wie vom CCP gewohnt, einzuschreiben. 
Diese Befehlszeile muß mit 00H abgeschlossen sein. 


Ist bei der Übergabe Register E=FFH, werden alle Daten bezüglich 
USER-Ebene und anzusprechendem Laufwerke vom aufrufenden Programm 
übernommen. Andernfalls werden die CCP-Vorgabewerte zum Aufruf 
verwendet. 


Mit Funktion 108 kann ein 2-Byte Wert zusätzlich an das folgende 
Programm übergeben werden, 
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+ 
I Funktion 48 Puffer freigeben l 
47------------ + 
Il Eingabe C=30H ı 
I E=Flag ı 
I Zurück A=Fehlercode l 
I H=Fehlernummer ı 
4--------------- + 


Diese Funktion veranlaßt, daß alle Daten, die noch in den inter- 
nen Puffer vorhanden sind, auf Diskette geschrieben werden, oder 
Puffer, die z.B. zum Datenvergleich angelegt wurden, freigegeben 
werden. 


Vergleichspuffer ( wie von PIP benötigt) werden freigegeben, wenn 
Register E=FFH ist. Andernfalls werden nur die internen (oder 
BIOS-abhängigen) Sektorpuffer abgearbeitet. 


Ist die Funktion erfolgreich, kehrt sie mit Register A=00 zurück. 
Andernfalls ist Register A=FF. In diesem Falle enthält Register H 
einen Fehlercode mit folgender Bedeutung: 


H=01 Schreibfehler (Disk-I/O) 
H=02 Diskette ist schreibgeschützt 
H=04 ungültiges Laufwerk 
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4----------- nn nn + 
I Funktion 49 lesen (schreiben) aus (in) SCB l 
4-------- nn + 
I Eingabe C=31H l 
ı DE=SCBPB-Adresse } 
I zurück A=Byte Wert ı 
l HL=eWort-Wert ı 
4------------- nn + 


Diese Funktion ermöglicht den Datenaustausch mit dem SCB (System- 
Kontroll-Block). 


Dieser Kontroll-Block ist ein 80H-Byte großes Datenfeld, in dem 
Flags, Daten und Zeiger abgelegt werden, die vom BDOS, BIOS und 
SCB gemeinsam benötigt werden. 


Zur Benutzung dieser Funktion ist es notwendig dem BDOS die 
Adresse eines Datenfeldes zu übergeben (SCBPB=SCB-Parameter- 
Block), das wie folgt aufgebaut ist: 


! 

2 

3 Ma a ScEHEE oo os 1 ; hier wırd der Gtfset eingetragen (gıbt Entiernung oes 
4 ; gesuchten Wertes vom Start oes SCE’s 
5 ‚an 

6 

7a’ 0 ds ! ; dıeses Flag hat folgende Beseutung! 
8 ‚ FF=setzen eines Eytes ım SCB 

g  Fessetzten eines Wortes ir SCH 

16  FO..el nıcht zugelassen 

N ; ntzlesen eines Wertes aus den SCH 
12 iz" a ds 2 ; hıer wird oer Wert aes zu schreib- 
13 ‚ engen Eytes ger Wortes Jbergeben 
14 ; wobeı f}r Eytes nur oer erste Wert 
15 ; gültig ist. 


Das Lesen von Werten aus dem SCB ist immer gefahrlos. Werden 
jedoch Werte neu gesetzt, liegt es allein beim Benutzer der 
Funktion, die Datensicherheit zu überprüfen. 


Falsche Daten können sehr einfach zu sehr unliebsamen Folgen 
führen. 


Wird als Offset ein Wert über 63H eingegeben, so bleibt die 
Funktion (ohne Störung) unbeantwortet; jedoch werden die Register 
A und HL mit den Werten 0 zurückgegeben. 

Der komplette Inhalt des SCB's ist nur teilweise offengelegt 
worden. Die bekannten Felder sind nachstehender Tabelle zu ent- 
nehmen: 

Achtung: 


Diese Funktion ist CP/M 3 typisch und kann nicht unter MP/M 
verwendet werden. 
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4+-——--- 4-0... + 
ı Offset ! Beschreibung ! 
44 4+----------- 2... 0.0... + 
I 09..94H Reserviert vom Betriebssystem ' 
1 95H EDOS-Versionsnummer ' 
1 06..09H Benutzer-Flags (frei verwendbar) ' 
I oA. .OöFH Reserviert vom Betriebssystem ' 
I 18..11H Fehlercode ! 
I 12: 19H Reserviert vom Betriebssystem l 
I 1AH Zeichen pro Zeile für Konsolenausgabe ! 
ı 1EH momentane Spaltenposition für Konsalenausgabe \ 
U ICH Zeilen pro Seite für Konsolenausgabe ' 
ı 1D..21H Reserviert vom Betriebssystem ' 
ı 22..23H CONIN Belegungsvek tor ! 
ı 24..25H CONOUT Belegungsvek tor ! 
ı 26..27H AUXIN Belegungsvektor ' 
1 28. .29H AUXOUT Belegungsvektor ! 
ı ZA. .ZEH LSTOUT Belegungsvek tor ! 
ı 2CH Seitenmadus (Flag) (page - nopage) ! 
I ZDH Reservıert vom Betriebssystem 

ı ZEH CNTRL-H Aktiv-Flag ! 
I ZFH DEL Aktiv-Flag \ 
ı 32..32H Reserviert vom Betriebssystem 

1 323..24H Koansplen Modus ! 
ı 35..26H Reserviert vom Betriebssystem 

ı 37H Ausgabe Delimiter (Funktion 9 Standard ist '’$’) 
ı 35H Druckerflag (Cntrl-p) ! 
I 39..3EH Reserviert vom Betriebssystem ı 
ı 3C..320H momentane DMA-Adresse ! 
ı 3EH Momentanes Laufwerk ' 
ı 2F..43H Reserviert vom Betriebssystem ! 
I 44H Momentane USER-Nummer (Ebene) \ 
I 45..43H Reserviert vom Betriebssystem ! 
U AAH EDOS Vielfach-Sektor-Zaehler (Funktion 44) ' 
ı AEH EDOS Fehler Modus (Funktion 45) ' 
I AC..AFH Laufwerkssuchkette (Laufwerk 1..2..3) ' 
I SOH Laufwerk für zeitweise Datenablage ! 
! 51H Laufwerk in dem zuletzt ein Fehler auftrat \ 
I 52..56H Reserviert vom Betriebssystem ' 
I 57H EDOS-Flag ı 
I 53..5CH Datum- und Zeit ! 
I 5D..S5EH Startadresse des gemeinsamen Speicherbereiches |! 
ı SF..FFH Reserviert vom Betriebssystem ! 
+----------------- 2-22. + 
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Tabelle 14 Eintragungen im System Controll Block 


4------------ m + 
I Funktion 50 Direkter BIOS-Aufruf l 
4 ----- + 
ı Eingabe C=32H l 
ı DE=BIOSPB-Adresse ı 
I zurück Register entsprechend den BIOS l 
l Rückgaben gesetzt l 
4------------- nn + 


Mit dieser Funktion können BIOS-Unterprogramme aus der BIOS- 
Sprungleiste direkt aufgerufen werden. 


In einem ungebankten (CP/M 2) System konnten aus der TPA heraus 
alle Funktionen, die aus der (festgelegten) Einsprungleiste des 
BIOS erreichbar waren, angesprungen werden. Unter CP/M 3 in einem 
gebankten System ist dies nur noch bedingt möglich. 


Nach wie vor erreichbar sind alle Unterprogramme die mit der EIN- 
oder AUS-Gabe von Zeichen auf die Konsole, den AUX-Kanal und dem 
Drucker zu tun haben. (Fast) alle anderen Einsprünge zeigen auf 
Unterprogramme, die im gebankten Bereich sind. 


Nun kann zwar ein TPA-Programm problemlos die entsprechende Ein- 
sprungadresse in der Sprungleiste des BIOS erreichen, die Adresse 
des Sprunges zeigt dann jedoch auf einen zufälligen Speich- 
erinhalt im TPA-Bereich. Das kann zu (zum mindesten) merkwürdigen 
Ergebnissen führen. 


Viele Hilfsprogramme zum Reparieren von Disketten u.Ä. unter CP/M 
2 benutzten die Unterprogrammes des BIOS zum direkten Disketten- 
zugriff. Unter CP/M 3 ist dies nun nur noch über Funktion 50 
möglich. 


Zur Datenübergabe ist es notwendig, das Register DE mit einem 
Zeiger auf ein spezielles Datenfeld, dem BIOSPB (BIOS-Parameter- 
Block) zu laden. Dieses Datenfeld ist vor dem Funktionsaufruf mit 
folgenden Daten zu laden: 


I 

2 kn" nd BlöSfE: ds 1 ; Kummer ges ElGS-Einsprimaes 

3 ; EOT=1, WEROT=2 usw 

4 

5 ’ 

& ‚ nachfolgend kinnen dıe von EI(S benitisten Regıster- 
7 ; inhalte )bergeben werden. Im BöüS werden alie 

& ‚ benannten Register vor gem ElGS-Einsprung enstprechend 
9 ; gelaoen. Die Reihenfolge ıst unver{nderbar 

18 ’ 

N 

12 ul’ 00 ds | ; Inhalt des A-kegısters ohne Flags 

13 6062’ 06a ss 2 ; Inhalt des Registers EC 

14 ind’ Bad «ss 2 ; Inhalt des Resısters D£ 

15 6ou6’ Boah ss 2 ; Inhalt des Resısters HL 


Nach Aufruf der Funktion werden dem Benutzer die Register mit den 
Originalinhalten wie vom BIOS gesetzt zurückgegeben. 


Es ist zu beachten, daß der Einsprung 27 (Bankauswahl) über 
Funktion 50 nicht angesprochen werden kann. 


127 


Nähere Angaben über die BIOS Sprungleiste sind in Teil IV (Hard- 
ware-Anpassung) zu finden. Die Sprungleiste selbst ist im Unter- 
programm BIOSKERNL abgedruckt. 


Der Vollständigkeit halber werden alle BIOS-Aufrufe mit den Über- 
gabekonventionen in der nachfolgenden Tabelle noch einmal zu- 
sammen gefaßt: 


+=---4------- -- +------- +---------- -- --------....-. + 
I Nr ! Funktion ! Eingabe ! Zurück \ 
+----+4------- -- +------- +------- —- - --- + 
ı © BOOT keine Startet CP/M (Kaltstart ! 
ı] WEOOT keine Lädt CCP (Warnstart) 

2 CONST keine A=FF wenn bereit ! 
! A=668 wenn nicht bereit | 
ı 3 CONIN keine A=Zeichen ! 
v4 CONÖUT C=Zeichen nichts ' 
ee LIST C=Zeichen nichts \ 
ı6 AUXOUT C=Zeichen nichts ! 
N 7 AUXIN keine A=Zeichen ' 
vB HOME keine nichts ! 
19 SELDSK C=Laufwerk HL=DPH-Adresse ! 
! E=Initflag HL=® wenn uncültiıg ' 
110 SETTRK EC=Tracknummer nichts ' 
ıl SETSEC BC=Sektöornummer nichts \ 
ı12 SETDMA EC=DMA-Adresse nichts ' 
113 READ keine A=0& Fehlerfrei ! 
ı A=#1 hardware A=FF media! 
114 WRITE C=debl. code A=68 Fehlerfrei \ 
\ A=#1 hardware A=FF media! 
115 LISTST keine A=68 wenn bereit \ 
! A=FF wenn nicht bereit | 
116 SECTRN EC=129 SEK-Nr HL=phys.Sektornummer ! 
\ DE=Adresse der Translatetabelle \ 
117 CONOST keine A=FF wenn bereit \ 
! A=66 wenn nicht bereit |! 
113 AUXIST keine A=FF wenn bereit ' 
! A=%8 wenn nicht bereit | 
119 AUXOST keine A=FF wenn bereit ! 
\ A=08 wenn nicht bereit | 
ı20 DEVTEL keine HL=DEVTEL-Adresse 

ı21 DEVINI C=DEV-Nummer nichts ! 
122 DRVTEL keine HL=DRVTEL-Adresse ! 
\ oder HL=FFFF ' 
123 MULTIO C=Sek-Zähler nichts ! 
ı24 FLUSH keine A=66 wenn Fehlerfrei 

125 MOVE HL=Zieladresse HL=HL+BC+] ! 
' DE=-Quelladresse DE=DE+EBC+] ! 
! EC=Länge ' 
ı26 TIME C=06 lesen nichts ! 
! C=FF schreiben ! 
127 SELMEM A=Banknummer nichts \ 
123 SETENK A=Banknummer nichts ! 
129 XMÖOVE B=Zielbank nichts ' 
ı C=Quellbank ! 
138 USERF für den Benutzer reserviert ! 
131 RESERVI für das Betriebssystem reserviert ! 
132 RESERV2 ! 
4+--—-- — 2... 0.0.0.0. + 


Tabelle 15 Zusammenfaßung aller BIOS-Aufrufe 
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4+---------- mm mn + 
I Funktion 59 lade Overlay I 
4+---------- nn + 
I Eingabe C=3BH l 
ı DE=FCB-Adresse ı 
I Zurück A=Fehlercode l 
ı H=Fehlernummer L 
4---------- nn + 


Mit dieser Funktion kann eine overlay-Datei an einen (fast) 
beliebigen Speicherplatz innerhalb der TPA geladen werden. 


Diese Funktion kann nur von Programmen benutzt werden, die mit 
GENCOM einen RSX-Kopf geladen haben, da die Funktion nur vom 
LOADER aus unterstützt wird, der seinerseits, nur wenn ein RSX 
geladen wird, resident bleibt. 


Mit dieser Funktion können COM- oder PRL-Dateien als overlay 
geladen werden. 

Unter einer overlay-Datei ist eine Datei zu verstehen, die nicht 
(unbedingt) nach Adresse 100H geladen wird, sondern nach einer im 
Dateienkopf (Header) angegebenen Adresse. 


Overlay-Dateien sind im allgemeinen Hilfs-Dateien, die von einem 
ablauffähigen Programm bei Bedarf nachgeladen werden. Ein typ- 
isches Beispiel hierfür sind die OVR-Dateien von Wordstar (R). 


Unter PRL-Dateien versteht man Programmsegmente, die so gelinkt 
wurden, daß sie auf jede beliebige gerade Seite transferiert 
werden können und dort ablauffähig sind. Unter Seite ist dabei 
(CP/M-typisch) jede Adresse zu verstehen, die ein Vielfaches von 
100H ist. (z.B. L1400H, 3900H, EO00H usw.) Diese Relozierung ist 
möglich durch ein dem Programm angehängtes Datenfeld, welches dem 
LOADER alle notwendigen Relozierungsdaten zur Verfügung stellt. 


Vor dem Laden eines overlay-Programmes muß der zugehörige FCB 
erfolgreich eröffnet werden. Die Zieladresse der Datei wird dann 
in den Bytes rO und rl des FCB's eingetragen. Der LOADER meldet 
einen Fehler, wenn die Zieladresse unter 100H liegt oder das 
Programm den LOADER überlagern würde. 


Die Funktion kehrt nach erfolgreichem Laden mit Register A=00 zum 
Aufrufer zurück. Die geladene Datei wird nicht aus dieser Funk- 
tion heraus ausgeführt. 


Wenn bei Aufruf der Datei der LOADER (d.H. ein RSX) nicht gefun- 
den werden kann, kehrt Register A=FF zurück. 


Entdeckt der LOADER eine ungültige Zieladresse oder steht zuwenig 
Speicherraum zur Verfügung, um das Programm zu laden, dann kehrt 
Register A=FE zurück. 


Im Fehlerfall A=FF meldet Register H noch folgende Fehler: 


H=00 LOADER nicht gefunden 
H=01 Lesefehler (DISK-I/O) 
H=04 Ungültiges Laufwerk. 


129 


H=Fehlernummer 


4-------- + 
I Funktion 60 Aufruf eines RSX ı 
4----------- + 
I Eingabe C=3CH l 
l DE=RSXPB-Adresse ı 
I Zurück A=Fehlercode l 

l 

+ 


Diese spezielle Funktion ermöglicht es dem Programmierer Unter- 
programme in einem (bereits geladenen) RSX aufzurufen, 


Der Zugriff erfolgt über das RSXPB-Datenfeld (RSX-Parameter- 
Block), mit folgender Bedeutung: 


l 
2 Et RÄFE: oo os 1 
EB ”b p_Anzahl 


RSX-Funk tionsnummer 
; Anzahl der folgengen Paraneter 








’ 
+. 3 
4‘ ee p_start! dw parameter] ; Vektor des Unterprogrammes 
Eu: “u dw parameter? ; Vektor mes Interpragramnes 2 
Bi DL) 4 parameter?  ; Vektor ges Unterprogrannes 3 
7% 49 dw  parameterN ; letzter Vektor 
2 sundd p_Anzahl au ($-p_start)/2 ; Z{nlen jbernımat der Assencler 


Wenn die genannte Funktion (d.h. Nummer des folgenden Parameter- 
vektors) nicht mit dem RSXPB übereinstimmt (dort nicht genannt 
ist), kehrt die Funktion mit Register A=FF zurück, andernfalls 
ist Register A=00 . 


Als Funktionsnummern sind 0..127 (0..7FH) für den Programmierer 


zugelassen. Die Nummern 128..255 (80..FFH) sind für das Be 
triebssystem reserviert. 
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li Funktion 98 Freigabe belegter Blöcke ı 
4+--------------- nn + 
ı Eingabe C=62H l 
I Zurück A=Fehlercode l 
ı H=Fehlernummer ı 
4+------------ nn + 


Mit dieser Funktion können Zwischendateien wieder freigegeben 
(d.h. im Inhaltsverzeichnis gelöscht) werden. 


Einige Programme legen Zwischendaten (temporary) auf Diskette ab, 
wenn der Arbeitsspeicher in der TPA zu klein wird. Zwischen- 
dateien dieser Art werden zwar mit Funktion 16 geschlossen, 
wurden jedoch durch Setzen von Bit 7 im 5. Buchstabens des 
Dateinamen markiert. 


Bei Aufruf der Funktion werden alle Dateien in allen initiali- 
sierten Laufwerken überprüft. 


Diese Funktion wird vom CCP nach jedem Warmstart aufgerufen. Es 
ist DAHER notwendig, daß alle (noch benötigten) Dateien die 
geöffnet sind, vor einem Warmstart korrekt geschlossen werden. 


Wurde die Funktion fehlerfrei abgeschlossen, kehrt sie mit Re- 
gister A=00 zurück, andernfalls ist A=FF und Register H=04. 
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4=------------- 0 + 
li Funktion 100 Direktory Label setzen l 
47------------- + 
I Eingabe C=64H ı 
ı DE=FCB-Adresse ı 
Il Zurück A=Fehlercode 1 
l H=Fehlernummer L 
+------------------ 2 + 


Mit dieser Funktion kann einer Diskette ein Namen (Label) zuge- 
wiesen oder ein bestehender Name geändert werden. 


Der gewünschte Diskettenname wird in einem FCB übergeben, der den 
üblichen Regeln für den Aufbau eines Dateinamen entsprechen muß, 


In Byte 0 des FCB's wird das anzusprechende Laufwerk definiert. 


Das EX-Feld kann einen zusätzlichen code mit folgender Bedeutung @) 
enthalten: 
Bit 7 Es wird ein Paßwort für entsprechend geschützte 
Dateien benötigt. 
Bit 6 Es sind Datums- und Zeitmarken bei jedem Dateien- 
zugriff einzutragen (access). 
Bit 5 Es sind Datums- und Zeitmarken nach jeder Datei- 
veränderung einzutragen (update), 
Bit 4 Es sind Datums- und Zeitmarken für jede neu 
generierte Datei einzutragen (create). 
Bit 0 Dem Directory Label wird ein neues Paßwort 
zugewiesen. 


Gesetzt wird eine Funktion, wenn das entsprechende Bit gesetzt 
(=1) ist. 


Ist der Diskettenname (Label) bereits durch ein Paßwort ge- 
schützt, muß bei jedem Aufruf dieser Funktion dieses Paßwort in 
die ersten acht Bytes der momentanen DMA geschrieben werden, 
bevor die Funktion aufgerufen wird. Dies ist nicht notwendig, 
wenn zuvor mit Funktion 106 das Paßwort als Vorgabewert (default) 
deklariert wurde. 


Wird der Diskette ein neues Paßwort zugewiesen (Bit O0=1), so wird ® 
dieses in den zweiten 8 Bytes der momentanen DMA-Adresse er- 
wartet. 


Die Benutzung dieser Funktion setzt ein erweitertes Inhaltsver- 
zeichnis der fraglichen Diskette voraus. Dieses erweiterte In- 
haltsverzeichnis wird mit dem INITDIR-Befehl generiert. 


Es ist nicht zugelassen die Funktions-Bits 6 und 4 gleichzeitig 
zu setzen (siehe hierzu den SET-Befehl). 


Die Funktion kehrt mit Register A=00 zum Aufrufer zurück, wenn 
sie fehlerfrei erledigt wurde. 
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Im Fehlerfalle meldet Register A=FF mit einer genaueren Fehler- 
angabe in Register H mit folgender Bedeutung: 


H=00 Inhaltsverzeichnis voll oder nicht mit INITDIR 
erweitert. 

H=01 Schreib- oder Lesefehler (Disk-I/O) 

H=02 Diskette ist schreibgeschützt 

H=04 ungültiges Laufwerk 

H=07 ungültiges Paßwort 
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47--------- 4 -- + 


I Funktion 101 Daten des Directory Label lesen I 
47=------------ -------- + 
I Eingabe C=65H ı 
ı E=Laufwerksnummer ı 
I Zurück A=Datenbyte des Labels ı 
ı H=Fehlernummer ı 
+7 ------ + 


Mit dieser Funktion kann das EX-Feld (Bit 12) des einer Diskette 
zugewiesenen Namens-FCB zurückgelesen werden. 


Dies gilt für die Diskette in dem durch Register <E> spezi- 
fizierten Laufwerk, wobei Laufwerk A=00, B=01 usw ist. 


Das zurückgegebene Datenbyte enthält eine Verschlüsselung mit 
folgender Bedeutung: 


Bit7 Es wird ein Paßwort für entsprechend geschützte 
Dateien benötigt. 

Bit 6 Es sind Datums- und Zeitmarken bei jedem Dateien- 
zugriff einzutragen (access). 

Bit 5 Es sind Datums- und Zeitmarken nach jeder Datei- 
veränderung einzutragen (update). 

Bit 4 Es sind Datums- und Zeitmarken für jede neu 
generierte Datei einzutragen (create). 

Bit 0 Dem Directory Label wird ein neues Paßwort 
zugewiesen, 


Gesetzt wird eine Funktion, wenn das entsprechende Bit gesetzt 
(=1) ist. 


Kehrt die Funktion mit Register A=00 zurück, bedeutet dies, daß 
der angesprochenen Diskette kein Name zugewiesen wurde, 


Kehrt die Funktion mit Register A=FF zurück, ist ein Fehler 
aufgetreten, der in Register H mit folgender Bedeutung näher 
bezeichnet wird: 


H=01 Lesefehler (Disk-I/O) 
H=04 ungültiges Laufwerk 
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4e=------ mm mm nn + 
il Funktion 102 Lesen der Datums- und Zeitmarken i 
ı und des Schutzmodus einer Datei l 
4e----------- om nn nn nn + 
I Eingabe C=66H l 
l DE=FCB-Adresse l 
I Zurück A=Fehlercode ı 
l H=Fehlernummer l 
4+--------- nn + 


Mit dieser Funktion kann das Datums- und Zeitmarkenfeld der Neu- 
generierung oder des letzten Zugriffes sowie der letzten Änderung 
der im FCB spezifizierten Datei zurückgelesen werden. 


Darüberhinaus werden Informationen darüber zurückgegeben, inwie- 
weit die Datei durch ein Paßwort (Kennwort) geschützt ist. 


Die Daten sind nach erfolgreichem Aufruf der Funktion ( Register 
A=00 ) dem entsprechend geänderten FCB zu entnehmen. 


Der Modus des Paßwort-Schutzes steht im EX-Feld (Byte 12) des 
FCB's mit folgender Bedeutung: 


Bit 7 Leseschutz 
Bit 6 Schreibschutz 
Bit 4 Datei kann nicht gelöscht werden 


Ein Modus ist dann aktiv. wenn das entsprechende Bit gesetzt ist 
(=l). 


Ist das RX-Feld auf Null gesetzt, bedeutet dies, daß der Datei 
kein Paßwort zugeordnet wurde. 


Die Datums- und Zeitmarken sind die Bytes 


24..27 für die Neugenerierung oder dem letzten Zugriff 
(create oder access) und 
28..31 für die letzte Änderung 


der Datei enthalten, Die entsprechenden Datenfelder sind auf Null 
zurückgesetzt, wenn keine Datums- oder Zeitmarken definiert 
wurden. 


Das Format der Datums- und Zeitmarken ist unter Funktion 104 
beschrieben. 


Im Fehlerfall kehrt die Funktion mit Register A=FF zurück mit 
einer näheren Fehlerbeschreibung in Register H bei folgender 
Bedeutung: 


H=00 Datei nicht gefunden 

H=01 Lesefehler (Disk-I/O) 

H=04 ungültiges Laufwerk 

H=09 unzulässiger Joker im Dateiname 


135 


ı Funktion 103 schreiben eines erweiteren (X)FCBs | 
4e=-=2------- + 
ı Eingabe C=67H l 
I DE=FCB-Adresse ı 
I Zurück A=Fehlercode ı 
l H=Fehlernummer ı 
4e=------- ------- 2-0 + 


Diese Funktion ermöglicht es einen erweiterten (eXtended) FCB zu 
generieren oder zu verändern, 


Ein erweiterter FCB enthält wie gewohnt die Laufwerksbezeichnung 
und den Dateinamen mit Index. Das EX-Feld ist hier jedoch nicht 
auf Null gesetzt, sondern enthält nähere Angaben über den Paß- 
wortschutz der angegebenen Datei, 


Die einzelnen Bits dieses 12. Bytes im XFCB haben dabei folgende 
Bedeutung wenn sie auf 'l' gesetzt sind: 


Bit 7 Leseschutz 

Bit 6 Schreibschutz 

Bit 5 Datei kann nicht gelöscht werden 

Bit 0 Zuweisung eines neuen Paßwortes für die Datei 


Wenn die Datei bereits durch ein Paßwort geschützt ist, wird 
dieses Paßwort in den ersten 8 Bytes der momentanen DMA-Adresse 
erwartet. 


Wird das Paßwort geändert, so wird das neue Paßwort in den zwei- 
ten 8 Bytes der momentanen DMA erwartet. Die Paßwortangabe ist 
nicht notwendig, wenn vor dem Aufrufen der Funktion mit Funktion 
106 das Paßwort vorgegeben wurde. 


Die Funktion kehrt mit Register A=00 zurück, wenn der XFCB er- 
£folgreich eröffnet oder verändert werden konnte, 


Andernfalls ist Register A=FF mit eine nähere Fehlerangabe in 
Register H mit folgender Bedeutung: 


H=00 Datei nicht gefunden oder kein Paßwort 
zugewiesen. 

H=01 Lese- oder Schreibfehler (Disk-I/O) 

H=02 Diskette ist schreibgeschützt 

H=04 ungültiges Laufwerk 

H=07 falsches Paßwort 

H=09 nicht zugelassener Joker im Dateinamen 
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I! Funktion 104 Datum und Zeit setzen l 
4+--------------- m + 
I Eingabe C=68H l 
ı DE=DTF-Adresse l 
de=--- nn nn + 


Mit dieser Funktion ist es möglich Datums- und Zeitangaben in den 
SCB zu übernehmen. 


Das Registerpaar <DE> muß beim Aufrufen der Funktion auf ein 
Datenfeld (Date-Time-Field) zeigen, in welchem die Uhrzeit und 
das Datum wie folgt abgelegt sind: 


Pa) DIF: s 2 ; Datum als ütfset vom 1.1.78 
3 a ds 1 ; Stunde (24n) ın ED 
A as | ; Minute @. 5% ın bib 


Die Angaben zum Datum sind als 16-Bit Wort (in HEX) zu setzen als 
Offset zum 1. Januar 1978. Dieses Datum entspräche dem Wert 0, 
der 10. Januar 1978 dem Wert OAH usw. 


Es sind CP/M 3 Versionen auf dem Markt, in welchen das Datumsfeld 
im SCB (System-Controll-Block) bereits auf einen anderen Zeit- 
punkt voreingestellt ist. Dieser Zeitpunkt kann leicht durch 
Aufruf des DATE-Befehles festgestellt werden (falls keine Uhr 
installiert ist). 


Die Angaben zur Stunde und Minute erfolgen als BCD-Werte, also 13 
für 13 Uhr oder 59 für 59 Minuten, 


Beim Aufrufen der Funktion wird das Sekundenfeld im SCB auf 00 
gesetzt. Soll das Sekundenfeld ebenfalls gesetzt werden, so kann 
dies nur über Funktion 49 geschehen. 


Aus dem CCP heraus sind alle Datums- und Zeitmarken mit dem DATE- 
Befehl setzbar. 


137 


l DE=DTF-Adresse 
! Zurück A=Sekunden 


+ 
ı 
+ 
li Eingabe C=69H ı 
l 
l 
I DTF gesetzt l 

+ 


Mit dieser Funktion kann das Datum und die momentane Uhrzeit 
gelesen werden. 


Die Datenübergabe erfolgt im DTF-Datenfeld. ( siehe hierzu Funk- 
tion 104 ) 


In Register A werden zusätzlich zu den Daten im DTF-Datenfeld 
noch Angaben über den aktuellen Sekundenstand, ebenfalls in BCD, 
zurückgegeben. 
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I Funktion 106 Vorgabepaßwort setzen ı 
4+----------- nn + 
I Eingabe C=6AH ı 
l DE=Paßwortadresse ı 
4+------------ nn nn nn + 


Mit dieser Funktion ist es möglich, das Paßwort vor dem Zugriff 
auf paßwortgeschützte Dateien vorzugeben,. 


Dies erleichtert dem Paßwort-Besitzer die Arbeit erheblich, da 
das Paßwort nicht immer wieder neu eingegeben werden muß. Es ist 
jedoch zu berücksichtigen, daß nach Aufruf dieser Funktion der 
Paßwortschutz quasi aufgehoben ist, bis ein Warmstart oder Dis- 
kettenwechsel stattgefunden hat. 


Beim Aufruf der Funktion muß das Registerpaar DE auf ein 8 Byte 
Datenfeld zeigen, welches das gültige Paßwort enthält. 


Ist das angegebene Paßwort ungültig, dann bleibt der Dateischutz 
erhalten. 
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jeresesee nennen se anne 
I Funktion 107 lese Seriennummer L 
+------------------ 22 „nt 
ı Eingabe C=6BH l 
l DE=SNF-Adresse l 
Aaa---------2-- 2 + 


Mit dieser Funktion kann die Seriennummer des benutzten BDOS in 
ein 6 Byte (Serien Nummer Feld)-Datenfeld gelesen werden. 


Achtung: 


Diese Funktion funktioniert im nichtgebankten cp/M 3 wie sie 
soll, im gebankten BDOS können jedoch Probleme auftreten. 


Hier scheint ein Fehler im BDOS vorzuliegen - aber wer braucht 
diese Funktion schon ..... 
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ı Funktion 108 lesen oder setzen eines Rückkehr- 
l codes bei Programmende 


I Eingabe C=6CH 

ı DE=FFFFH (lesen) oder 

ı DE=Programmcode (schreiben) 

I Zurück HL=Programmcode (falls lesen) 


Diese Funktion ermöglicht es dem Benutzer einen 16-Bit-Code einem 
danach aufgerufenen Programm zu übergeben. (siehe hierzu auch 
Funktion 47 ). 


Folgende Vorgaben stehen dabei zur Verfügung: 


0000..FEFFH erfolgreicher Programmabschluß, 

FF00..FFFEH Programm wurde mit Fehler abgeschlossen 
wobei folgendes gilt: 

FF80..FFFCH reserviert vom Betriebssystem. 

FFFDH Programm wurde wegen nicht behebbarem BDOS- 
Fehler abgebrochen. 

FFFEH Programm wurde durch CNTRL-C abgebrochen. 

0000H wird vom CCP automatisch eingefügt, wenn das 


nächste Programm nicht mit Funktion 47 
aufgerufen wird, 


FFFFH reserviert für Datenabfrage. 


Alle nicht reservierten Kombinationen können zu beliebiger Da- 
tenübergaben zwischen verketteten Dateien benutzt werden. 


141 


4=--------------- + 
I Funktion 109 Konsolenmodus setzen oder lesen L 
4=-------------------- + 
I Eingabe C=6DH ı 
t DE=FFFFH (lesen) oder l 
l DE=Modus (setzen) l 
I Zurück HL=Modus (wenn lesen) ı 

+ 


Mit dieser Funktion kann die Konsole auf verschiedene Art der 
Dateneingabe gesetzt oder die gesetzten Werte zurückgelesen 
werden. 


Die einzelnen Bits des übergebenen Datenwortes haben folgende 
Bedeutung: 


Bit 0 =1 Der mit Funktion 11 aufgerufene Status kehrt 
nur bei CNTRL-C mit dem Wert 01H zurück. 


=0 Mit Funktion 11 wird bei jeder Zeicheneingabe 
mit OlH zurückgekehrt. 


BIT 1 =1 Bildschirmausgabe wird mit CNTRL-S angehalten 
und erneut freigegeben (CP/M-2 Modus). 


=0 Bildschirmausgabe wird mit CNTRL-S angehalten 
und mit CNTRL-Q wieder freigegeben. 


BIT 2 =1 ungefilterte Konsolenausgabe. Es wird die 
Expansion von TAB's in den Funktionen 2,9 
und 111 unterdrückt, ebenso die Unterstützung 
des Mitdruckens mit CNTRL-P. 


=0 Normale Konsolenausgabe wie unter Funktion 2 
angegeben. 


BIT 3 =1 Programme können nicht mit CNTRL-C abgebrochen 
werden, 


=0 Programme können mit CNTRL-C abgebrochen werden. 

BIT 4..7 reserviert vom Betriebssystem, 

BIT 8,9 Diese Bits geben an, wie der Konsolenstatus defi- 
niert wird, wenn ein RSX benutzt wird um den Kon- 
soleneingang (auf andere Kanäle) umzulenken: 

8=0-9=0 Wird der Konsolenstatus aufgerufen, so kehrt 


die Funktion immer mit A=00 zurück, außer wenn 
dem ersten Aufruf sofort ein zweiter Aufruf 


folgt. 
8=0-9=] Der Status ist immer A=00 
8=1-9=0 Der Status ist immer A=FF 
8=1-9-1 Umlenken der Konsoleneingabe nicht zugelassen 


Die restlichen Bits werden nicht benutzt. Der Konsolenmodus wird 
vom CCP vor dem Laden jedes Programmes auf 0 gesetzt, außer ein 
RSX setzt Funktion 109 außer Kraft. 
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I Funktion 110 Lesen oder Setzen des Endezeichens | 


ı bei der Textausgabe ı 
4+-------------- nn + 
I Eingabe C=6EH l 
l DE=FFFFH (lesen) l 
ı E=Endezeichen (setzen) ı 
I Zurück A=Endezeichen (beim Lesen) ı 
4=-------- + 


Mit dieser Funktion kann die Textende-Marke neu definiert werden. 


Mit Funktion 9 können beliebige Texte ausgegeben werden, bis das 
Textabschlußzeichen '$' erreicht wird. 


Diese Zuweisung wird nach jedem Aufruf des CCP's neu deklariert. 
Sollen Texte ausgegeben werden, in welchem das Dollarzeichen '$' 
verwendet werden muß, so kann anstelle des Dollarzeichens ein 
anderes Zeichen definiert werden, 
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ı Funktion 111 Ausgabe eines Textblockes l 
4---------- --=------------- + 
I Eingabe C=6FH l 
l DE=CCB-Adresse l 
}#-=------------ + 


Diese Funktion ähnelt der Funktion 9, nur wird hier keine Text- 
endemarke verwendet sondern dafür ein spezielles Datenfeld ein- 
gerichtet. (Character Controll Block). Dieses Datenfeld ist wie 


folgt definiert ist: 
1 


Pa] CB: “s 2 hier ist dıe Adresse bei ger ser 
3 ; Text begınnt 
4 ss 2 ‘ hierher Laenge des Textes 


Mit dieser Funktion ist es möglich z.B. Texte in einem Block zu 
schreiben und durch geschicktes Auslegen des CCB's aus diesem 
Textblock Ausschnitte zur Mehrfachverwendung auszuwählen. 


das------- == mn one nn + 
ti Funktion 112 Drucken eines Textblockes ı 
4--------- 2222-2 nn + 
I Eingabe C=70H l 
l DE=CCB-Adresse l 
4+----------- 22 + 


Diese Funktion entspricht der Funktion 111 nur wird die Ausgabe 
direkt auf den Drucker (LST-Device) ausgegeben. 
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I Funktion 152 Generieren eines FCB's l 
4e=------ m nn + 
I Eingabe C=98H 1 
l DE=FCBPB-Adresse l 
I zurück HL=Fehlercode l 
4=-------- m nn + 


Mir dieser Funktion ist es möglich die Generierung eines FCB's 
dem BDOS selbst zu überlassen. Bei Aufruf der Funktion muß das 
Doppelregister DE lediglich auf eine Datenfeld zeigen (FCB-Para- 
meter-Block), in welchem folgende Zeiger einzutragen sind: 


I 


2 dd FÜR: ds 2 ; Adresse des Textputfers cer den 
3 ; Dateinamen enth(lt 
Az s 2 ı Adresse des (32-Eytes) Futfers 


Der Textpuffer soll den Dateinamen in folgender Form enthalten: 
(d:)dateinanet .typ)(;kennwort) 


Es kann Groß- oder Kleinschreibung (auch gemischt) verwendet 
werden. Der Dateiname kann 1..8 Zeichen lang sein, der Index 0..3 
Zeichen und das Paßwort ebenfalls 0..8 Zeichen. 


Der Inhalt des Textpuffers kann vom Programmierer vorgegeben oder 
z.B. mit Funktion 10 vom Benutzer eingegeben werden, 


Bei der Namenseingabe ist zu berücksichtigen, daß einige Zeichen 
als Textendemarke erkannt werden, d.h. Text, der auf eine Text- 
endemarke folgt wird nicht mehr interpretiert. Leerzeichen oder 
TAB's am Anfang des Puffers werden unterdrückt. Die infrage 
kommenden Textendemarken sind nachfolgend aufgelistet: 


Leerzeichen (blank) 

TAB (Tabuiator) 

RETURN (cr) 

NALL (60H) 

; (Senikelen) ausser vor eınem Kennwort (Passwort) 
= (6leichheitszeichen) 

< und > (groesser oder kleiner als...) 

: (Doppelpunk) ausser nach der Laufwerksangabe 
‚ (Komma) 

ı (Senkrechter Strich) 

[U und ] (eckige Klännern) 


Wenn die erste gefundene Textendemarke eine NULL oder ein RETURN 
ist, kehrt die Funktion mit dem Doppelregister HL=0000 zurück. 
Wird eine andere Textendemarke gefunden, kehrt HL mit der Adresse 
dieser Marke zurück. 


Konnte kein gültiger Dateiname generiert werden, wird HL=FFFF 
übergeben, 
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Der aufgebaute FCB 


fcb: 


2 


= 


= 


ds 


drive 


"FILENANE! 


'EAT 


9,9,9,9, 
"REIMWORT' 


3,9 


entspricht dem nachfolgenden Listing: 


; Laufwerksnunner @degerade queltiges 
; Laufwerk, Al=Laufwerk A, Al=Laufwerk B usw 

; Dateinane (im FCB in Grossbuchstaben) 

; 1 Zeichen minımal 3 Zeichen maximal 

; \nbenutzte Stellen nıt Z&H (Leerzeichen) 

; auffuellen 

; Index des Dateinamens (in Grassbuchstabent 
;% Zeichen minınal 3 Zeichen maximal 

; Unbenutzte Stellen mıt 201 (Leerzeichen) 

; auffuellen 

; Mıt ®9 fuellen (interne Zeiger) 

; Namen aes Kennwortes (in Gressbuchstaben) 

; maxımal 8 Zeıchen. Autfuellen mıt Zuh fuer 

; nıcht benutztes Kennwort der nıcht benutzte 
; Stellen. 

; benutzt vom Betriabssysten 
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Das Programm selbst fängt die Eingabe von CNTRL-C ab, um einen 
Warmstart in den CCP zu ermöglichen (und nicht einen Kaltstart 
über RESET zu benötigen). 


1 3009’ contest! 

2 

3 ; 

: ; Unterprogramm zum Testen von sattware zur Kansolerınterstuetzung 
ß 

Tiny‘ FD 14 a,ötah ; aırekte Zeicheneingabe 

3 0002’ CD Muor" call console ‚ veriangen 

3 005’ FE 03 cp [x 3 CNTRL-C ? 

19 07" CA Er jp 2,9 ; wenn ja ann warastart 

11 eat CD wur" call  cansnle ; sonst Zeichen ausgeben 

L 60 13 FI Ir contest ‚ und alles von vorne .. 

14 Kuh En cansale:ld [913 ; Funktion & 

15 so]1' SF ld 2,3 ; Zeichenueneraane in Regıster E 
In dal2' CD du all 5 ; Eiis-Autrut 

17 :m15' (3 ret 


Die Anwendung einer der CP/M 3 typischen neueren Funktionen soll 
das nächste Beispiel verdeutlichen. 


Hier wird mit Funktion 111 Text ausgegeben, der keine Textende- 
marke hat wie dies von Funktion 9 benötigt wird. Das Beispiel 
zeigt auch, daß es mit dieser Funktion möglich ist, beliebige 
Ausschnitte aus einem Textblock auszuwählen. 


Der Funktion wird in einem Kontrollblock vor jedem Aufruf ein 
Zeiger auf den Text-Anfang und die Textlänge übergeben. 





1 5! test! 

2 

3 ' 

4 ; Ausgabe von Textblescken auf die konsole 

5 f 

5 

Tin call 5a , Ausgase ces Textes wıe getiniert 
3 13 ni,text3 ; Zeiger auf sen Text 'NiE’ 
36 la (ccb),hl ; in den (CB 

{ Id hl,3 ; 3 Zeichen 
14 (ceb#2),hl ; @bentalls in sen CC 
a call 5m ; run aıesen Text ausgeben 

13012? 21 dr ld hl,text2 ; Zeiger aut sen Text 'VERZAGT ... 
14 3615° 22 0036’ 14 (ccb),nl 

15 518 Z1 00 ld hl,9 ; 9 Zeıchen (incl Leerzeichen) 
16 Mid’ 22 033° ld (ccb+2),hl 

17 mie" CÜ db’ call cm 

13 021° 21 id hi,textl ; Zeiger auf "EIN NEGER ...' 
19 uu24’ 22 als" 14 (ecb),hl 
20T 14 hl,9 ; 9 Zeichen ausgeben 
ZI WER" 22 dag id (ccb+2’,hl 


2 

23 

24 

25 

2 

27 0020’ && &F GH 
23 Our’ 11 0036° 

29 32 CD es 


a ar ccb: 
37 0038’ On2C 

£:3 

39 


Lr} 

42 45 IE text! 
44 bo4F' 6 76 65 72 text2: 
45" GE EI ES A textät 
4 MX len] 
4 

4 


: Aufruf der Blockausgaberautine 


ld om 
ld ne,ccb 
call 5 

ret 


f Character Controll Elock 


D 


dw text] 
dw len] 


: Texibereich 


& "Ein hegar kıt Gazelle’ 
db ’ verzagt im Regen ' 
[.) 'nıe’ ‚edr,dah 

equ $-textl 


end 
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Die Generierung eines RSX-Programmes, 


Der Übersichtlichkeit halber ist das folgende Beispiel sehr 
einfach gehalten. Das Programm soll lediglich bei der Drucker- 
ausgabe die Ausgabe des Kontrollzeichens 0OAH (linefeed) ver- 
hindern. 





Kaaıı uue Bel BT 200} 2b 9,0, ; Platz fuer (P/m Seriennunser 
u 2 it Jp  RSIPRÜG ; Einsprung in RSX-Prograna 
3° 03 met pp $-$ ‚ Einsprung in's EIS 
ec" prev: de 8 ; Adresse vorheriges Modul 
5 dene’ FF remv! ch ÖFFH ; SFFh=ja Öskeneın 
Di nonbrik 1b 4 ; SFFkanicht gebankt ®=gebankt 
7 ma’ 52 63 58 20 a 'RSI-NArE’ ; RSX-Nane 
: Mi 2 9,0,9 ; CP/M resarviart 
" BSITZ REÄFRÜG 
j 
12 deik" 79 ld a,C ‚ EiuS-Eatenl in <C) 
13 lc" FE 65 cp 5 ; LIST 
14 ii’ 20 02 Jr nz, one y ... wenn nıcht LIST 
15:09’ 78 ld 3,2 ; ASCHI-Zeichen 
I al’ (8 ret z ; ..LFnıcht drucken 


17 
12 


13 ; LFwırd in <A) oem EiniS-Callar zurueckgegeten 
en ;CRETZ) cer 'Rest’ wırd geüruckt 

2 

2ER UNI dene: jp NEXT 

24 

25 end 


Dieses Programm muß nun noch CP/M 3-gerecht aufbereitet werden: 


A»MSB Tsxname, =rswname 

A>LINK rsxnamelE] 

A:REN rsxmame. Psx=rsxname.spr 
A>SENCOM top rsxname 

A,Tüp 


Zuerst muß das Programm assembliert werden. (Die Syntax kann hier 
bei Verwendung eines anderen Assemblers anders sein - es wird auf 
jeden Fall die Generierung einer REL-Datei erwartet). 


Mit dem CP/M-Programm LINK.COM wird nun eine SPR-Datei generiert. 
Darunter ist eine Datei zu verstehen, die aus einer REL-Datei 
eine Datei generiert, die vom LOADER auf jede beliebige Seite 
reloziert werden kann. Unter Seite ist dabei jede Adresse zu 
verstehen die ein ganzzahliges Vielfaches der Adresse 100H ist. 
(Also z.B. 4500H oder OEAOOH). Ermöglicht wird diese Relozierung 
(Verlagerung mit Adressanpassung) durch eine mitgenerierte 
Tabelle, aus welcher der LOADER erkennen kann, welches Byte im 
Programm an die Zieladresse angepaßt werden muß. 
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Zur Verwendung der Datei mit dem Hilfsprogramm GENCOM muß der 
Index .SPR in .RSX umbenannt werden. Die Inhalt der Datei ändert 
sich dabei selbstverständlich nicht. Die Umbenennung ist aber 
notwendig, da eine RSX-Datei wie aus dem Listing zu erkennen ist, 
einen sog. HEADER (Kopf) hat, Eine normale SPR Datei hat diesen 
aber nicht. Der RSX-Index dient so der Erkennung und verhindert 
eine falsche Anwendung der Datei. 


Mit GENCOM wird nun die RSX-Datei z.B. mit dem Textprozessor 
TOP.COM 'verbunden'. 


Schaut man sich nach dem Anhängen des RSX-Programmes das "neue" 
TOP.COM mit z.B. DUMP an, so stellt man fest, daß der erste 
Befehl nun 'C9' lautet -— RET(urn). Dies würde unter CP/M 2 immer 
zu einem Warmstart führen. Dort könnte ein RSX-Programm also 
keinesfalls funktionieren, genauergesagt nicht einmal aufgerufen 
werden. 


Unter CP/M 3 prüft der LOADER nun nach, ob es sich bei dem gerade 
geladenen Programm um ein RSX-Programm handelt. Ist dies der 
Fall, wird der RSX-Teil vor den LOADER transferiert und in das 
System eingebunden. Dabei wird die Sprungadresse des BDOS-Ein- 
sprunges auf Adresse 0005H auf die Einsprungadresse des RSX- 
Programmteiles abgeändert. (Sie zeigt im Beispiel also auf die 
Adresse auf welcher die Anweisung 'jp RSXPROG' steht). Danach 
wird im Programm der RSX-Anteil "abgehängt' und das eigentliche 
Programm an seine Zieladresse (100H) nach vorne transferiert und 
ausgeführt. 


Jeder Aufruf der Adresse 0005H führt nun unweigerlich über den 
RSX. Dort wird in unserem Beispiel geprüft, ob in Register C die 
Funktionsnummer 5 ( Drucken des Zeichens in Register E ) steht. 
Ist dies nicht der Fall, wird zum regulären BDOS weitergesprun- 
gen. Ist es Funktion 5, wird geprüft, ob das Zeichen in <E> ein 
OAH (linefeed) ist, wenn nicht wird ebenfalls zum BDOS weiter ge- 
sprungen. Andernfalls wird das Zeichen nach Register <A> umge- 
laden und dem Aufrufer unbenutzt zurückgegeben. 


Soll der RSX von unserem TOP-Programm wieder ab'gehängt werden, 
genügt die einfache Eingabe: 


ADGENCOM TOP (er?) 
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Als weiteres Beispiel ist ein Programm aufgeführt, welches die 


Benutzung der Diskettenfunktionen verdeutlichen soll. 


Aufgabe des Programmes DUMP ( das im Übrigen nicht mit dem mitge- 
lieferten DUMP.COM identisch ist ) ist es, den Inhalt einer Datei 
auf dem Bildschirm in HEX- und ASCII-Darstellung auszugeben, 


daß der CCP den Spei- 


Im Beispiel wird die Tatsache ausgenutzt, 
Puffer 


cherraum 0000H..00FFH zur Ablage von Dateinamen und als 
benutzt. 

Der folgende Speicherausdruck zeigt z.B. den Speicherinhalt von 
Adresse 0000..00FFH nachdem der Befehl 


dump b:sid.com 


eingegeben wurde, also die Aufforderung den Inhalt des Programmes 
SID.COM auf Laufwerk 'B' auf der Konsole auszugeben. 
NCaRa FaFFAl Ca Ma DZ FFFFFFFFFFFFFFFF 
U FF FF FF FFFFFF FF FF FF FF FF FF FF FF 
I FFFFFRFFFFFFFREFRFFFFFFFF FE FF FE FF 
a: FF FF FF FF FF FFFF FF FF FF FF FF FF FF FF FF 
a FF FR FF FR FF FF FF FF FF FFFFFFFF FF 
BF FF FR FFEF FF FF FF FF FF FF FF 6253 49 44 
N er A za 2 
Mm 202 20 2 za aa Er FF FF 


FEERSERIEFER: ga. 
FEFFERERRE u... 


nnmnn 


l 
F 
F 
F 


0: 09 62.34 72 69 64 ZE 63 EF ED OD FF FF FF FF FF 
“ai FF FF FF FF FF FF FF FF FF FFF FF FF 
U FF FF FF FF FE FF FF FF 


F 
F 
Eh: FF FF FF FF FF FF F 


.bisid.c..... 


F 
F 
Fi 
F 
F 
F 





nam 

mn1nnnnnn 
nnmmnmmmm 
annnnmnn 


F 
F 
F 
FF 


Der Textinhalt nach dem Programmaufruf DUMP ist im Speicherbe- 
reich 81H abgelegt; abgeschlossen mit 00H. 


In Speicherstelle 80H ist die Länge der (Rest-) Befehlszeile 
eingetragen (09H= 9 Zeichen). Ab Adresse SCH ist nun die erste 
Zeile eines FCB's eingetragen, beginnend mit der Laufwerksnummer. 
Im Beispiel ist dies 02H entsprechend Laufwerk 'B'. Laufwerk A 
wäre OlH. Wäre eine 00H eingetragen, so würde damit das derzeitig 
gültige Laufwerk gemeint sein (das default-Laufwerk), falls es 
nicht explizit in der Befehlszeile eingegeben würde. 


Ab Adresse 5DH steht nun der Dateiname, umgewandelt wie von CP/M 
benötigt in Großbuchstaben und auf 8 Stellen mit Leerzeichen 
aufgefüllt. 


Ab Adresse 65H beginnt der Index, ebenfalls in Großbuchstaben. 
Die darauffolgenden 4 Bytes sind auf NULL gesetzt und repräsen- 
tieren das EX-Feld, Das Sl- und S2-Feld sowie das RC-Feld. 


Zu einem kompletten FCB gehören nun noch die Felder DO..Dn und 
das CR-Feld. Der Inhalt dieser Felder wird beim Eröffnen einer 
Datei vom BDOS eingetragen, kann beim Programmaufruf also noch 
unberücksichtigt bleiben. Der CCP benutzt diesen Speicherraum 
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(von 6CH ... FFH) um wie oben gezeigt einen Rumpf-FCB einer 
zweiten Datei einzutragen, falls diese in der Befehlszeile ange- 
geben wurde z.B. wie folgt: 


Adnyprog b:teill.bin e:teil2.bin 


In diesem Falle sähe der Speicherbereich wie so aus: 


@abaı FFFEFFFEFFFFFFFEFEFEFFFEOZSAUSUS O...22........ Tel 
bosa: AC 31 26 26 26 42 49 AE Oo 06 bo 06 05 54.4549 LI Bin..... Tel 


un: AU 32 Zu 20 20 42 49 A Oo be a FFFEFF L2 EiN....... 
Mh 17 62 A 746569 E62 EI 2574 .biteill.bin eit 
ee 2 EEE FFFFFEFFFFFFFF eilZ.bın........ 


Im Beispiel wird nun der bei 5CH beginnende FCB direkt ausgenutzt 
und der Bereich 80..FFH als Puffer verwendet. Dieser Bereich ist 
bereits vom CCP als Vorgabe DMA initialisiert. Ebenso wie der CCP 
Funktion 44 mit dem Vorgabewert 1 initialisiert hat. 


Dies bedeutet, daß jeder Leseaufruf 128 Byte (=80H) in den vorge- 
gebenen Puffer schreibt und zwar solange, bis das Dateiende 
erkannt wird. 


Im Beispiel werden keine anderen Fehlermöglichkeiten abgefragt. 
Wenn Register A nicht NULL ist, wird davon ausgegangen, daß das 
Dateiende ereicht wurde. 


1 Snkakckpnkeniikn np rerkapharka kt 
2 x + 
3 2 DM - Hılfsprogramm zur Darstellung des Dateieninhaltes % 
4 ‚+ in HEX und ASCII auf ger konsole 4 
5 x Geschrieben von Raoul 0. koerber, Detmold 1 
6 32 7337757577757757775757575077773 2777777337777 72532797399755 77777 
7 

& ’ 

9 ı Vereinbarungen 

16 ’ 

N 

12 5 bios eg ach ; Eini& Einsprungadresse 

13 eioh tpa equ [ar  Beainn oer TFA 

14 

15 @uSc tfcb em Sch ; oort ist der FE 

16 003% tsize equ ein ; Fuffergroesse 

17 [u] tbuff equ 1)  Futferadresse 

18 

19 ' 

% ; ASCII-Zeichen 

2 i 

2 

23 [auch cr equ en ; RETURN 

24 baoA 1f eu ah ; linefeed 

25 [a blank equ Ah ı Leerzeichen 

2% 
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34 9103 
35 #15 
35 #197 
37 ala 
361% 
Er) 

4u alör 
4 A112 
42 9115 
43 5118 
44 9119 
45 HA 
46 AlD 
4 

48 alir 
43 Hi2l 
&9 al2d 


Erg JE} 
53 9135 
240137 
Al 

521 
63 #139 
64 
65 
EN) 
67 al5E 
Er 
69 a1dd 
7a 0141 
71 9142 
72 al4S 
73 #idh 
74 0148 
75 6149 
76 AldR 
77 Hl4C 
73 @l4U 
79 old 
29 0161 
31 6153 
2.955 
33 8157 
84 ala 
85 615 
26 A150 
37 915 
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LIE) 


Am 
FED 
2209 
1 #103 
DEE) 
13 5 


OEE JE: 
2 olım 
CD alal 
87 

je) 

CD #lir 
12 Fb 


11 59 
9 9131 


aline! 


alınl! 


alın: 


ı Programmstart 


org 


tpa 


a,(tfcb+l) 
blank 

nz, Jump] 
Je, 1090 
9 

bios 


ren 
hi,ipa 
reads 
a 

nz 
wourf 
loop 


h,B 
ae, tuff 
crif 
snahl 
de,nl 
alıra 
de,nl 
Je 

de, lin 
hi,ge 
ge 
wbufl 


e,(nl) 
nl 
se,hl 
snahl 
@e,hl 
alın) 
hl 
b,16 
a,(hl) 
hl 

7th 
nc,dlin3 
blank 


ıst eine (atei angegeben? 

dann darf hıer kein 'blank’ sein 
weiter wenn nicht 

sonst Syntax melden 

Textausgabe 

yeber das BO0S und Warnstart 


Dateı eroetfnen 
Angenommene Startadresse 
Sektor lesen 

Fehler ? 

dann Warnstart (zurueck) 
Pufferhınalt ausgeben 


8 Zeılen 

Pufferadrasse 

reue Zeile 

angenommene Startadresse ausgeben 
Fut faragressa 

Aussade eıner Zeile zes Pufferinhaltes 
Futferagresse rette 
Pufferadresse retten 

Naue Adresse 

berechnen 

Putferagresse 


TFA-Adresse 
Zaehler retten 
Zeiger retten 

3% Wort ausgeben 
Inhalt erstes Byte 


Inhalt zweites Byte 
Zeiger auf naechstes Byte 
Regıster tauschen 
und inhalt von HL ausgeben 
Regıster zurueck 

38 
Zeiger aut Zeilenantang 
16 Zeichen 
Zeichen lesen 
und Zeiger auf naechstes Zeichen 
ASCII (übergrenze?) 
wenn nıcht 
ASCIT (intergrenze?) 


nıcht Oruckbares als Funkt ausgeben 
Zaıchen ausgeben 

16# 

Zaehler 


& 
80 
% 6168 
EI JE 
2 6166 
Be 
94 616 
95 @l6l 
% 6ikD 
47 @i76 
% 
4 0172 
I6% 6173 
el a17E 
162 6177 
182 617A 
164 6i7C 
165 
1er @iTE 
167 @i7r 
es 1) 
109 E18 
Ne 8iE2 
111 6id} 
112 @l6e 
113 
114 187 
115 6169 
116 elke 
17 eK 
NE let 
NIEIF 
Ir} 
121 09 
122 6193 
123 61% 
124 
IARIEN 
1% 019 
127 0% 
128 01X 
129 01% 
139 6irb 
131 
132 01Al 
133 6IA2 
124 @1AS 
135 6147 
136 @1AA 
137 GiAB 
18 
139 @IAC 
146 6103 
14 
142 


Ar open! 


TC smnl: 


et 
CD 187 
A 


E& er htoa! 


Et) erlf: 


I) conaut ! 


03 reads! 


au aA 44 61 mtile: 
6) AA 44 55 logo! 


a 
(tfcb+32) ‚a 
ae,ttch 
c15 

boos 

a 

z 

oe,mfıle 
sm 


htoa 
at 


eo llib 
a, 


a,dn 
commut 


a,ct 
comut 
a,lf 


2 
e,ä 
baos 


de,tfcb 
[ey] 
b3as 


A=ü 
RC loeschen 
Zeiger aut FE 
Datei eroeffnen 
mıt BiXıS-Aufrut 
Fehier ? 
. wenn nıcht 
sonst relgen 'bateı nıcht ...’ 


zuerst <H?> 
in HEX ausasben 
dann ÄL) 


cann eın Leerzeichen anhaengen 


Zeichen retten 


(heres nıbole nacn unten schieben 
und in H£I ausgeben 
num oberes nıbtile 


oberes nınble maskleren 
und ın dezieal wandeln 
eın bısschen kompliziert 
aber kurz und schnell 


alle Register retten 
konscienausgabe 
Zeichen 


alle Register retten 
FCB-Adresse 
seq. lesen eines Sektors 


alle kegıster zurueck 


cr,lt,'Dateı nıcht gefunden$‘ 
cr, If, "MP wırd aufgerufen mıt DM? (di)filel.ext)$' 
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Ein etwas "ausgefalleneres' Programm, 


Das letztes Beispiel soll noch einmal die Anwendung eines RSX- 
Programmes zeigen. Die Aufgabe dieses Programmes es ist, in einem 
CP/M 3 System Programme ablaufen zu lassen, die durch direkte 
Aufrufe der Diskettenunterprogramme im BIOS unter CP/M 3 eigent- 
lich nicht funktionsfähig wären. Das Listing zeigt auch deutlich 
die Anwendung des BDOS Funktionsaufruf 50. Ebenfalls wird gezeigt 
(da es in diesem Falle emuliert werden muß), wie der blocking-, 
deblocking Algorithmus funktioniert. 


Eingebunden werden kann dieses Programm z.B. in der älteren 
Ausführung von DU.COM oder DUTIL oder (zumindest für teilweise 
Benutzung) bei POWER.COM. Es sollte auch unter SUPERZAP.COM 
funktionieren. 


Das Listing folgt ab der nächsten Seite. 


Die gezeigten Beispiel sind sicherlich nicht ausreichend, um alle 
Möglichkeiten auszuschöpfen, die CP/M dem Programmierer bietet. 


Die CP/M Users Group bietet jedoch dem Anfänger, dem Fortge- 
schrittenen und dem Profi eine Vielzahl von Programmen mit 
Source-Listings, die so ziemlich jedes Detail und jede Möglich- 
keit der Programmierung unter CP/M zeigen, 


Im Übrigen ist es hier wie überall, nur die Übung macht den 
Meister und Probieren (Programmieren) geht über Studieren, 


156 


'CF/M 2.2 Simulation’ 
Alle Rechte geschuetzt 


oO snın an — 


ZZ md’ en a 
23 

24 Wo" 13 ORTE" 

25 hans’ 13 Oo 

26 Anl" Ode 

27 @abe' FF 

ZE ON" A 

See 233% 
a a) 

a 


37 

ei a rt 
33 BEE’ 12 00°’ 
46 az’ 3 0951’ 
a1 0624’ 13 0054’ 
42 027° 03 57’ 
43 662A' 13 H65A’ 
44 020’ 3 sh" 
45 0630’ (3 @hke’ 
Me 0933’ 13 Wr’ 
47 66%' (3 0005’ 
au a 3 ae’ 
43 X’ 3 611A’ 
St zZ 
51 0842’ 63 6liF’ 
S2 @45' (3 Al2t’ 
53 6648’ (3 6678’ 
54 ande 03 6117’ 
55 

5 

5 

En 
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RRRRERRHRRERRIRRRRRRERREREERRERERBREKERRERIRRHEEIERRRPRRRR KR RR 
; Dieses CP/M3-RSX erlaubt es ’alte’ CP/M2 Programme die dırekt 

; auf das EIOS zugreifen, ablaufen zu lassen 
PRRRRRRERRRRRRRRRRRRERERRRRRRERERRRRRERRERERKRI ERROR Rh Echt 


’ 
Mahal 
, Vereinbarungen 
Set 
ja eu 1 
nein eu mt Ja 


’ 
‚ 2ıanaapaıaıı 
» RSX Header 

ik 


fs 68 ; wird veberschrieben 
entry: jp boot 
next!  jp 44 ; naechstes Moaul 
prev; dfw € ; vorherigers Madul 
remove! neib ja ; RSX loeschen bei Warmstart 
manbrk: detb nein ; nur ungebantt ? 

od RZ" RSK-Titel 

eb 0,8 

3aaınkaamd 

; EI0S(2.2) Sprumstahelle 

332333773 72777 77 
cbt: jp vooat ; kaltstart 
wbt! Jp wboot ; barmstart 

jp xconst ı konsolen Status 

jp xconın ; Konsolen Einaabe 

jp xcomut, ; Kensclen Ausgabe 

jp xlist ; Drucker 

jp xauxout » Auk Ausgabe 

jp xauxin » AUX Eingabe 

Jp home ; Dısk home 

jp selosk ; Disk anwaehıen 

jp settrk ı Track setzen 

ip setser ; Sektor setzen 

jp setma °  ; DMA Adresse setzen 

Jp read ; Sektor lesen 

p write ı Sektor schreiben 

jp xlistst ; Drucker Status 

jp sectran ; Sektor umrechnen 


: ana 


ı 6108 (°) Sprungtabelle 
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sg 
&9 
hl 


ktttgptkkhtaht 








62 Rd" 13 Wacd xweaot! jp 9 

63 Ma51' 13 wo xeonst! jp a 

54 5 [3 a xconin: jp [) 

65 5957' 13 A0a8 xconaut: jp 9% 

£&6 5a 13 eu xlıst! jp [) 

67 050’ 13 ai xamaut!jp 0) 

E93 a 3 xauxin: jp [) 

59 06 3 Jp () 

79 We" 3 era Ip {) 

7 won! 3 Kid Ip 0) 

72 wel" 13 den jp L) 

73 sueF' 13 duo Ip 1) 

74 um72' 3 on Jp 9 

75 975° C3 Gem Ip % 

76 78° 3 a xlıstst: jp [) 

7 

78 ; 

73 ‚ hrkkarehrkkhstek 

a ; kaltstart 

z I RHRRRRRSSERERRRE 

33 

24 7b F5 boot: push at ; alle Eins-Register 
35 970’ 09 aux ‚ retten 

58 70 21 Mund’ ld hl,next und Einsprung 

37 aoea' 22 97" 13 (entry+l),hl ; umdefinieren 
23 CD call int ; EIS 'Ersatz’ 

53 6 ZA id hl,(ı) ‚ alte Sprungadresse 
lt 22 ac ld (ola$aadr),hl ; retten 

9] mc’ 11 Mrd’ 13 de,wwooot  ; interne Sprungtabelle 
42 asp" el zl 14 bc,1583 ; aıt Orıgıaladressen 
33 092" ED 59 Ldır ; fuellen 

34 994° 21 GulE' ld hl,wbt ; neuer Warnstart 

35 97" 22 Hal ld (,hl ; nach im#1 ablegen 
2 Dr ; Regıster zurueck 
37 5038" Fl pop af 

33 ml’ 03 dd‘ Jp next 

00) i 

191 5 HRRERSEERRRRERASERRSRRRSRERKRURRRRRRIRARRRKSER RE 
lu2 ; Ab nıer beginnt as 'reue' (CFim-2) EIUS 
193 3 HRuRchkhkERsHhhkhtgRgerecRchRReRShRaRrhrsgRRERERK 
14 ; 

195 

Is i 

197 ur > 3133733777375 1 

128 ; Warmstart 

189 ; terkkkhtrgeghktt 

113 i 

11 

112 29" 2A WAC"  wbaat: It hl, (ola$acdr); zurueckspeichern ces alten 
113 @oA2' 22 wahl ld (D,hl ; 510$-eınsprunges 
114 AS’ EI jp (hl) 
115 
116 F 
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117 

NE 

119 

126 

121 

122 

123 

124 

125 

V2e @oAE' AR 
127 60A7' 
128 oaA' 
129 bung! 
130 Aut‘ 
131 0063" 
132 

133 

134 

135 

136 

137 

138 eat’ 6 32 
133 0665’ 11 62BE’ 
14u Br’ 12 

141 OuBA’ 13 Ging’ 
142 

143 

144 

145 

146 

147 

148 

149 ent’ A 6298 
156 @aC#' 87 

151 BOCı" CA 621 
152 66Ca' AF 

153 Macs’ 32 025° 
154 0008’ 32 6297° 
155 Ach’ 32 6293’ 
156 Gute’ 32 628€ 
157 Maul’ 32 6288’ 
155 6004’ (9 

19 

160 

16] 

1&2 

163 

164 

165 

166 es’ 79 

167 boDh' 32 6220" 
168 0009" 32 620e' 
169 @60C' 3E 09 
170 @GLE' CD eur‘ 
I71 6681’ 7C 

172 @02° ES 

173 663’ 08 

174 @0E4’ SE 


& 


DRIN 0 
Dr Se En cz 


init: 


xbıos: 


seldsk: 
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nraıaprkktrkd 
interna 
2a 


. 
’ 
“ 
' 
’ 
‘ 
D 
“ 
’ 
D 
. 
D 
D 
D 


xor a 

ld (hstwrt),a 
ld (hstact),a 
ld hl,8%h 

ld (dnaadr),hl 
ret 


ı Imterprogramm um: gebanktes ElCX ueber Eind&-call 'S6' 


; zu bearbeiten 


ld c,58 

ld de,bıospb 
ld (de),a 

Ip next 


4212 kahk 


home 
2nnakkatlnlı 


ld a,(hstert) 
or a 

call  nz,writehst 
xor a 

ld (hstwrt),a 
ld (hstact),a 
ld (unacnt),a 
ld (sektrk),a 
ld (sektrk+1),a 
ret 


’ 

‚ 42th pakkkak 
, Disk ansprechen 
‚ 4r2222ıklanıgdk 


ld ac 
ld (sekask),a 
ld (berea),a 


ld 3,9 
call  xbıes 
ld a,h 
or 1 

ret z 

ld e,(hl) 


’ 
. 
D 
. 
0 


hier geht es hauptsaechlich garım den blocking- 
oeblocking Puffer zu inıtıalısieren 


Hostpuffer an oen Anfang 


‚ Standard DMA setzen 


EIXS-Funktiom 
Parameterbiock 
EIOS-Funktion ablegen 
und Funktion ausfuehren 


; pruste ob schreiben‘ 


; Dimp purfer aut Diskette 


Putfer geschrieben 

Puffer inaktıv 

loesche alloc-Zaehler 
und Trackzaehler 


; Lautwerksnummer 


ın EIOSF& ablegen 
BIOS Funktionsnunner 


Fehler pruefen 


wenn Selectfehler 


; sonst Adresse der XLT-Tabelle 
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175 ES’ 23 Inc hl 

176 ak’ 56 ld d, (hl) ; in dummy-DPH 
177 O6E7' EB ex de,hl 

178 wies’ 22 Mzal’ ld (xlat),nl  ; retten 

179 HER’ 21 GB ld Al,1l ‚ Offset 

159 Ute’ 19 add hl,de 

131 90er’ SE ld e,(hl) 

182 ara’ 23 inc hl 

133 WFl’ 56 14 4,(hl) 

184 @0r2' EB ex ce,hl 

135 uF3' 22 Wak3' ld (apb),hl ; dumay DFB 

156 a6’ 7E ld a,(hl) ; Sektoren/Track 
187 MurT' 32 020’ ld (spt),a 

139 MurA' 23 inc hl 

139 GUFB" 23 ine hl 1%; 
1 Wfl" 23 inc hl ; black shift mask 
191 MFD’ 7E id a,(hl) 

192 re’ 32 0243° ld (bsm),a ; ablegen 

193 H1a1’ 11 uunc 14 de,12 ‚ offset auf psh 
194 0194’ 19 and hl,de 

135 o105' 7E ld a,(hl) ; psh lesen 

196 als’ 32 9244’ la (psh),a ; ung ablegen 
137 alas’ ZI 028E’ Ib) hl,öpn ; Airesse nes umay 
198 aluc' C9 ret 

19 

A] ’ 

26] ; RRRKKRERIKKRERKE 

202 ; Track setzen 

293 1 31277337777773 

20 i 

25 

206 Alöu' ED 43 MISE’ settrki 14 (sektrk),be 

267 All’ C9 ret 

Zug 

209 ; 

219 ‚ ttktkhtstkkteng 

211 ; DA setzen 

212 s Arekkabahektkkhk 

213 ' 

214 


215 #112’ ED 43 AZAA' setdma: Id (cmaadr),bc 


216 Hllb’ CI ret 
217 


218 i 

219 ‚ kktkarsakkkrkkkr 

229 ; Sektor berechnen 

22l ‚ trekkkkikkiktikrr 

22 ; 

223 ; hıer ist eine potentielle Fehlerquelle, falls Progranne 
224 ‚ sıch dıe XLT-Tabelle selbst berechnen kann hier 

225 ; ein Fehler 'uebergeben’ werden.... 

226 ’ 

227 

228 al17' 69 sectran: ld lic ; Eingabesek tor=Ausgabesek tar 
229 9113’ 68 ld h,b 

220 a119° c9 ret 

231 

22 ; 
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233 DB 3333334937 335777 

224 ; Sektor setzen 

235 IB 3433793377377 751 

236 i 

237 

228 e11A' 73 setser; ld a,C 

239 H11B' 32 62%" 1d (sekser),a 

244 @lik’ C9 ret 

241 

242 i 

243 Sanukkrakkn 

244 ; Sektor lesen 

245 Ip > + 3597 >> > 99373 %° 

24 : 

247 

248 OF! & 0) read: Id a,] ; lesen 

249 6121’ 32 62A7° ld (readop),a ; ankuendigen 
256 0124" & inc a ; a=2 = walloc 
251 6125’ 32 0249’ ld (wrtype),a 

252 018° 13 lt’ jp alloc 

253 

254 i 

255 kahl 

256 ; Sektor schreiben 

257 aaa 

258 i 

269 

zZ @l2e' Ar write: xor a ‚ schreiben 
261 ei2t’ 32 6247’ ld (reamp),a ; anluenaigen 
262 elf’ 79 ld a,c 

263 61%’ 32 0249’ 1d (wrtype),a 

24 6133’ Fk 02 cp 2 ; wnalloc Elock ? 
25 6135' 6 19 jr nz,chkuna __ 

267 


33 ‘ schreibe in den 1. Sektor eines nıcht belegten Elocks 
269 gas nachfolgenge Progranssegient entspricht oem 


270 ‘ (ge)blocking wie unter (P/M 2 verwendet 
2m ; 

22 

273 0137’ u &2A3' ld a, (bsn) ; block shıft mask 
27 01’ K inc a ; Ausgleich 

275 018 32 0294 ld (wnacnt),a ; Zaehler 

276 613€’ 3A 0280’ ld a,(sekdsk) ; und flags imtialisieren 
IN 2 ld (unadsk ),a 

278 6144’ 3A 028E' ld a,(sektrk) 

279 M147' 32 0296" ld (wnatrk),a 

2% Hiah’ 3A 02%’ ld a,(sekser) 

2&1 Alab' 32 02%’ id (unaset),a 

282 

283 e1ba' 3A 0299’  chkuma: Id a,(wmacnt) ; wnbelegte Sektoren 
284 6153’ 67 or a ‚ in dıesem Block ? 
Ka ar jr z,alloc ;... wenn nıcht 
286 6i56' 0 dec a 

287 017" 32 0299 ld (wnacnt),a 

233 615A' IA 6280’ id a,(sekdsk) 

229 1b" 21 O29R' ld hl ‚unadsk 

2% #16R' BE cp (hl) , sekdsk=unaisk? 
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a1 2 jr nz,alloc ..... wenn nıcht 
292 n163’ 3A H28E' id a,(sektrk) 
243 A166’ 21 324B’ 1d hl,unatrk 
294 9159’ BE cp (hl) ; sektrk=umatrk ? 
235 0A 0 22 jr nz,alloc }... wenn nıcht 
236 BlEC’ 3A 020" 14 a,(seksac) 
27 AiEF" 21 aa 14 hl,unasec 
233 0172° GE cp (hi) ; seksec=unasac? 
243 073° zu 19 jr nz,alloc i.... wenn nıcht 
:#0 4175’ 34 inc (hl)  naechstar Sektor 
al 176° 7E ld a,(hl) 
2 MT" 21 92AW°’ ld hl,spt 
a3 Al7A’ BE cp (hl) ‚ sektorsspt ? 
394 178° 33 YB ir c,nonvf ’ ... wenn kein leberlauf 
5 Al7D° 2A au" 13 hl, (wnatrk) 
a6 5 23 inc hl 
7 A151" 22 0igk’ id (unatrk),hl 
3 Ar zar a 
9 0155’ 32 a2" ld (unasec),a ; reset Sektorzaehler 
319 91383° AF mavfi xor a 
10859" 32 Haas’ 14 (rsflag),a ; nıcht "vorher'-lesen 
212 #lSC’ 13 03 Jr Twoper 
allac! wor a ; vorner jesen 
id (unacnt),a 
En Inc a 
317 6193" 32 a2AS' 1J (rsflay),a 
318 
319 W156" Ar FWIPeP: Xor a 
3.9 0197’ 32 G2A5’ ld (arflag),a ; keine Fehler bısner 
321 al" ZA aaa! 19 a,(psn) — ; physical shıft factor 
322 #10’ 87 or a 
323 9138’ 47 id b,a 
324 HI’ 2A 92° ld a,(seksec) ; logıscher Sektor 
325 alA2’ 21 9206’ 1d hlınsteuf  ; "eigener’ Sektorpuffer 
326 HiAS’ 11 A090 ld Je,123 ; 109 sektor Groesse 
327 alAS' 28 50 jr z,nchlk ı ... keın blocking 
323 @1AA’ EB ex de,hl 
329 AlAB' EB shift! ex de,nl 
3:9 HIAC’ BF rrca 
231 alAD’ 30 #1 jr nc,snl 
332 KiAr’ 19 ad hl,dge 
333 dicd' ER shli ex @e,hl 
334 HiBl’ 29 a2 nl,nl ‚ verdopple offset 
325 AlB2’ E& 7F and tn 
336 A184’ 19 F5 dinz shift 
337 aieß’ EB ex de,nl __ ; hlsfutferadresse 
33 67’ 32 02%’  mebik: la (seknst),a — 
339 MrA’ 22 a24k’ ld (sekbuf),hl 
349 H1ED’ 21 9297’ 14 hl,nstact  ; Puffer aktiv-flag 
241 AlCa’ 7E 14 a,(nl) 
4240 #0 ld (hl),] ; aktıvıeren 
243 0103’ 87 or a ; bereits fertig 
344 HICd’ 3 22 jr z,fılnst ‚ sonst Puffer fuellen 
245 All’ 3A a2ED’ 19 a, (sekdsk) 
346 #169’ 21 0291’ ld hl,hstask  ; gleiches Laufwerk 
247 AICC’ E& cp (hl) 
343 H1C0’ 39 12 jr nz,mmatch ; .. wenn nicht 
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349 ELF" SA O28L' 
359 6ib2' 21 0292’ 
35] @iD8’ BE 

352 606’ 20 69 
353 08" A 0296’ 
354 6106’ 21 0234’ 
355 @i0t’ Br 

356 biDr' 2 24 
3857 

SE IE’ A 6295° 
359 #i£4’ 87 

3 its Ca 2a’ 
3] 

3%2 bike’ A 628’ 
363 bieb' 32 6291° 
354 bikE' 2A O2&L' 
35 6ifl’ 22 6292’ 
So eird" A 0236' 
37 biF7' 32 6294’ 
5 BA A 026’ 
39 HiFü’ 87 

370 GIFk’ (4 6235' 
371 eu" Ar 
2 32 0285 
373 

374 0205' 2A 62’ 
375 6263’ EB 

376 6203’ ZA 029E' 
377 6266’ 3A 62A7' 
37E Azur" B7 

379 6216 2% 66 
sel x el 
381 6214’ 32 62%’ 
322 0217' EE 

393 

34 ezlE' el er 
35 6218’ ED BA 
Ser 620° A 02a9' 
327 020" FE 6) 
Eu 777002) 
339 0224° 3A 625’ 
3 6227 67 

391 028° 2 67 
392 QZ2A' A 

393 028° 32 0298’ 
344 02’ (u 0241’ 
395 6231’ 3A 6245’ 
396 6234" (3 


463 

de4 0235' CD 240’ 
465 02%’ £ 60 
det OA" CD id 


5 Feb & 11:63 ZEHASM 1.24 Fage 


ld a,(sektrk) 

id hl,hsttrk 

cp (nl) 

jr nz,nomatch 

ld a, (sekhst) 

ld hi,hstser 

cp (hl) 

Jr z,ratch 
nomatchild a, (hstwrt) 

or a 


filnst: 


atch: 


Fwmave; 


exit! 


call  nz,writehst 


; gleicher Track 

s .. wenn nicht 

; gleicher Fuffer ? 
i .. wenn Ja 

i Putfer geangert ? 


i .. Putfer losschen 


ld a,(sekosk) — 


ld (hstdsk ),a 
ld hl, (sektrk) 
ld (hsttrk),hl 
ld a, (sekhst) 
ld (hstsec),a 
ld a,(rstlag) 


a 
call  nz,readhst 
xor a 
ld (hstwrt),a 


ld hl, (maadr) 


ex de,hl 

ld hl, (selbut ) 
ld a,(readop) 
or a 

jr nz, Twmove 
ld a,] 

ld (hstwrt),a 
ex de,hl 

ld be, 128 
laır 


ld a, (wrtype) 
cp I 


jr nz,exıt 

ld a,(erfiag) 
or a 

jr nz,exit 
xor a 


ld (hstwrt),a 
call  writehst 
ld a,(erflag) 


‚ A242222 21 Kh 28 


; lesen ? 
ı wenn ja 


; schreiben inaktıv 


; lesen oser schreiben 
} ... wenn lesen 
; hl=ama desputfer 


; leg sektor Groesse 
; transfer... 


; LiR-Öperation ? 
 fertıg 


; kein DiR falls 


flag Puffer geschrieben 


3... Schreiben 
; Fehlerflag 


; Sektor lesen (CF/M3) 


‚ 423221142174 


reacdhst:call  rwint 
ld a,13 
call xbios 


» EI0S Read 


7 
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497 020° 32 0245' ld (erflag),a 
468 9249’ (3 ret 

449 

419 ’ 

4) ‚ kuangtiekktiitr 
42 ; Sektor schreiben 
43 ‚ Ankkkktksskkkrng 
44 ’ 

415 

416 9241’ CD 9240’  writehsticall rwsınit 
4179244’ X E ld a,14 

418 9246' CD Abd’ call  xbıos 

419 6249° 32 W2AS’ ld (erflag),a 
429 024C' (9 ret 

421 

42 i 

423 ‚ Kaarttreekiktrgr 
24 ı Anpassungen 

425 un 9 179375773 93799 7 
46 ’ 

427 

42a A — rwinıtilu a,(hstsec) 
43 9259 BF ld l,a 

4 ld h,8 

431 9253' 22 9209’ ld (bereg),hl 
422 0256' 2A @2Al’ ld hl, (xlat) 
423 4259’ 22 9202’ ld (dereg),hl 
4:4 0250' & 19 ld a,16 

435 925E’ CO 084’ call xbios 

4:6 9261' 7D ld al 

437 H262’ 32 9295’ ld (actsec),a 
423 0265’ 22 0200’ ld (bereg),hl 
439 0263’ 3E 08 ld a,1l 

449 B26A’ CD Abd" call  xbios 

441 9260’ 2A 0292’ ld hl,(hsttrk) 
442 0270' 22 02C0' ld (bereg),hl 
443 4273’ £ 9A ld a,10 

444 9275' CD @ab4’ call xbios 

445 9278' 21 9206’ ld hl,hstbuf 
446 0276’ 22 a2C0’ ld (bereg),hl 
MUT EEK 1d 3,12 

449 0 CD call  xbios 

443 9289 3E 01 14 a,l 

45) 2" 32 OZEF' ld (arag),a 
451 929° 3E IC 14 2,23 

452 BEA" 03 Gond’ jp bias 

453 

454 ’ 

455  teieeatsktkettee 
455  varıabla 

457 RT 77 732777777774 
453 i 

459 

dc al sekaski sefs 1 

461 H2SE 2 sektrki defs 2 

462 029° ag] seksec: dets 1 
3 A hstdsk: defs 1 

464 0272" 092 hsttrki defs 2 
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‚ evtl Fehler ablegen 


(CPI) 


; BIOS WRITE 


phys. Sektarnummer 


(BC)=Sek tornumner 


(BEI=XLT-Adresse 
BIOS SECTRN 


aktueller Sektor 


» <BCd=Sek tornumser 
B10S SETSEC 


phys. Tracknumner 
<BC>=Tracknumner 
8105 SETTRK 


Sektorpuffer 
<EC>=interne DrA-Adresse 
BIS SETGMAR 





Eankrunner 
BIOS SETERK 
DMA-Eank setzen 


; logisches Laufwerk 
; logischer Track 

ı logıscher Sektor 

; phys Laufwerk 

ı Phys Track 


’CP/M 2.2 Simulation’ 
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465 6294’ 
466 6295" 
467 6298 
462 0237' 
463 0238 
479 0299 
an ezan' 
472 62%" 
473 020" 
u74 62%" 
475 B2Al 
476 H2Al’ 
AT e2h3' 
478 H2A4' 
473 6246 
480 62A6' 
ae) @ZAT' 
452 6283' 
453 0203" 
aBa 62AR’ 
485 B2AC’ 
4% 

487 

4533 

489 

4% 

49] 

42 

433 

494 


435 b2AL' ® 


4% 62B%' 
497 EZ" 
4393 b2EA' 
493 et! 
5 
5a] 
562 
563 
54 
Ses 
56% 
567 62tk' 
563 62BF' 
569 0200' 
510 62C2' 
SI @2ca' 
512 
513 
514 
515 


[0] 
wa] 
a 
0061 
[u] 
6961 
Lie] 
002 
au] 
a2 
era 
6a? 
en 
Lu] 
661 
a] 
eo 
[au 
6692 
2 


a2 


0001 
6961 
0002 
6002 
ee2 


hstsec: 
artser: 


Kb: 


bıospb! 
areg! 
bereg: 
dereg: 
hlreg: 


dets 
gefs 


‚ı dets 
ı defs 
 dets 
ı defs 
ı gets 
ci defs 
ı dts 
ı defs 


dets 
defs 
defs 
oefs 


ı dets 
ı defs 
ı oets 
ı gefs 
ı 0815 
ı 0efs 
old$addr :defs 
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; phys Sektor 

; uebersetzter Sektor 

 phys Sektor (Zwischenablage) 
; Pufferflag 

Futfer-wachsel flag 

unalioc Sektorzaehler 
Lautwerk 

Track 

Sektor 

log Sektoradresse im Puffer 
Sektoren pro Track (aus Dre) 
XLT-Adresse 

block shift maske 

phys shift factor 
Fehlerflag 

.. Sektor lesen 

I wenn lesen - @ wenn schreiben 
phys Lesefiag 

schreiben 

, DMA-Puffer Adresse 

; Aoresse des 'alten’ bios 


DD - - vononoooo.-. oo 


3222231221 18 
int. Dfn 


Dıe Daten hıerzu werden aus den CF/M 3 DPH vebernonen 


eis 
defs 
dets 
defs 
dets 


’ 
‚attnkırhkhktnk 


‚e ; kein XLT 
ı 2.2 scratch 


anmmhn 
; EIOSFE 
anna 


dets 
defs 
defs 
defs 
defs 


DD — 


i 
tarerkkkatdktaydk 
; Hostputfer 
Syakkkkakkkkkarnla 


: Dieser Bereich dıent als Puffer zum Umsetzen von 
» max 1624 Eyte Sektoren unter (F/M 3 ın 122 Eyte- 
; Sektoren unter (P/M 2 
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523 a2ch'  adum hstouf: 
524 
525 
56 
527 
5 
53 
5:9 
ER 
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dets 1024 ; solle jecentalls reichen 


; 

‘ Der gesante benaetigte Speicherbereich muss catınıort 
‘ werden, damıt der RSX nıcht in aas EI0S hırein’ragt'. 
i 


end 


% Erroris) detected. 1734 Program Bytes. 


78 Synbols Detected 


166 





Glossar 


167 


168 





Dieses GLOSSAR soll helfen, immer wieder verwendete Begriffe 
etwas zu verdeutlichen: 


Adresse 


Der Speicher eines Computers ist in eine Vielzahl von einzelnen 
Bytes ( mit jeweils 8 Bits) unterteilt. Zur Orientierung werden 
alle Bytes durchnummeriert. Die jeweilige Nummer eines Bytes, 
beginnend mit 0 bezeichnet man als Adresse. Adressen werden 
üblicherweise hexadezimal (sedezimal) angegeben. 


Algorithmus 

Unter diesem Begriff ist eine Rechenvorschrift zu verstehen, mit 
deren Hilfe bestimmte Rechenvorgänge erledigt werden. 

Assembler 

Programm mit dessen Hilfe Programmieranweisungen, die in Mnemonics 


(siehe dort) geschrieben sind, in die entsprechende Maschinen- 
sprache umgewandelt werden. 


So wird z.B. aus der Anweisung: JP F400 
der Maschinencode: c3 00 F4 
Attribut 


Im Umgang mit Computern ist es recht häufig notwendig für bestim 
mte Vorgänge Kennzeichen zu setzen um damit Entscheidungskrite- 
rien beim Programmablauf zu bekommen. Ein typisches Beispiel ist 
das Setzen eines Paßwortes. Diese Kennzeichen bezeichnet man als 
Attribut, wenn es es zu einem bereits vorhandenen (und anderwei- 
tig benutzten) Zeichen hinzugefügt wird. Für Attribute bietet 
sich das (unbenutzte) 8. Bit von ASCII-Zeichen an, das vor der 
Bearbeitung wieder maskiert (im Sinne von wegnehmen) werden. 


BDOS 

(Engl: Basic Disk Operating System - Disketten (Grund) -Betriebs- 
System). Dieser Begriff gilt allgemein für ein entsprechendes 
Programm und besonders für einen Teil des Betriebs-Systemes CP/M. 
Es ist in diesem Falle der hardware-unabhängige Teil von CP/M. 
BIOS 

(Engl: Basic Input Output System - Grundsystem für Eingabe und 


Ausgabe). Dies ist unter CP/M der hardware-abhängige Teil des 
Betriebs-Systemes. 
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Bank 


Normalerweise ein Platz, wo man sich setzen kann - oder wo's Geld 
gibt. In diesem besonderen Fall sind di.runter 64k-Speicherbe- 
reiche zu verstehen, die nicht direkt von der CPU adressiert 
(angesprochen) werden können. Durch spezielle hardware können die 
64K-Segmente über Port-Befehle einzeln gesetzt werden. Jedes 64K- 
Segment bezeichnet man als Bank. 


Befehl 


Ein Befehl. auch wenn er in verschiedenen Variationen auftreten 
kann, bedeutet im Enderfolg jedoch immer dasselbe: eine Anweisung 
an den Computer etwas ganz bestimmtes zu tun. 


Die unterste Ebene eines Befehles ist der Maschinenbefehl. Dies 
ist ein Code-Wort, das von der CPU direkt 'verstanden' und ausge- 
führt wird. 


Die höchste Ebene sind Programme, die geschrieben wurden, um 
einen ganz bestimmten Vorgang einzuleiten. 


Betriebssystem 


Hierunter ist eine Anzahl von Programmen und Programmsegmenten zu 
verstehen, die es ermöglichen einen Computer in soweit in Betrieb 
zu nehmen, so daß dieser eine sinnvolle Arbeit verrichten kann 
und Massenspeicher (wie Disketten oder Kassetten) als zusätz- 
liches Speichermedium bedient werden können. 


Bit 


Dies ist die kleinste "Recheneinheit' eines Computers. Ein 
Bit kann nur zwei Werte annehmen 0 oder 1 (falsch oder wahr). Auf 
diesen zwei möglichen Werten basiert die gesamte Boolsche 
Algebra. 


Block 


Ein Block ist unter CP/M die kleinste Einheit, die mit einem 
Eintrag im Inhaltsverzeichnis einer Diskette abgelegt werden 
kann. Bei Standard-CP/M (8" einfache Dichte) sowie bei allen 
Disketten mit einem Speicherplatz < 256K ist die Blockgröße 1024 
Bytes (=1K-Byte). Bei Disketten mit größeren Speicher-kapazitäten 
beträgt die Blockgröße meist 2048 Bytes (=2K-Byte). Die 
höchstmögliche Blockgröße ist 16K-Byte. 


Etwas inkonsequent werden von Digital Research in den Unterlagen 
zu CP/M mehrmals Sektoren als Blöcke bezeichnet. 
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Boolsche Algebra 


Rechenvorschriften im Umgang mit Bits und Bytes. Es gelten 
folgende Regeln: 


AND OR XOR NOT 
0 andO0 =0 0o0r0=0 0xor 0 =] not 0 = 1 
0andl=0 0or1l=]1 0 xor 1=0 not 1=0 
land 0 = 0 lor0=]1 l1xor 0 =0 
landl=] lor1=]1 lxor1=]1 

Boot 


(von Engl: bootstrap=Schnürsenkel). Dieser Ausdruck wurde von der 
amerikanischen Redewendung ' sich am Schnürsenkel aus dem Dreck 
ziehen' abgeleitet. Gemeint sind im Zusammenhang mit Computern 
alle notwendigen Vorgänge, bis der Computer (vielmehr sein Be- 
triebs-System) bereit zur "Arbeitsaufnahme' ist. 


Byte 
Dies ist die Zusammenfassung von jeweils 8 Bits. Ein Byte ist die 


kleinste adressierbare Einheit in einem Computer-System. Ein Byte 
kann folgende Werte annehmen: 


binär hexadezimal dezimal 
00000000 00 0 
00000001 01 1 
00000010 02 2 
00000011 03 3 
00000100 04 4 
usw 

11111100 FC 252 
11111101 FE 253 
11111110 FE 254 
11111111 FF 255 


Es ist zu beachten, daß ein Byte zwar 256 Werte annehmen kann, 
diese in Zahlen ausgedrückt jedoch nur im Bereich von 0..255 
gehen. 


In einem Byte sind die einzelnen Bits von Rechts nach Links 
nummeriert. Das äußerste rechte Bit ist Bit 0, das äußerste linke 
Bit ist Bit 7. 


CccP 


(Engl: Console-Command-Prozessor - Konsolen-Befehls-Ausführer),. 
Dies ist ein Programmsegment von CP/M. Der CCP erlaubt einen 
gewissen '"Dialog' mit dem Betriebs-System und ermöglicht es Pro- 
gramme aus dem Speicherraum einer Diskette aufzurufen. 
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Code 


Im allgemeinen die Verschlüsselung von Worten, Anweisungen 
oder Befehlen. Bei Computern spricht man bei den Maschinen- 
Befehlen meist ebenfalls von Code (im Sinne einer verschlüsselten 
Mnemonic-Anweisung). 


Wenn bestimmte Bits in einem Byte als Attribut verwendet werden, 
kann es sich ebenfalls um einen Code handeln. 


CP/M 


Es wurden schon viele Übersetzungen dieses Namens "angeboten', 
Digital Research, der "Besitzer' von CP/M gibt dazu keine 
Angaben. Die Übersetzung "Control Program/Monitor' dürfte noch am 
sinnvollsten sein. 


CP/M ist ein Diskettenorientiertes Betriebssystem, das ursprüng- 
lich für die 8-Bit CPU's 8080 und 280 von Gary Kindall entwickelt 
wurde. 


CPU 


(Engl: Central-Prozessor-Unit - Zentrale-Rechnungs-Einheit). Man 
versteht darunter einen Baustein (oder im Falle von Großcomputern 
auch eine Gruppe von Bausteinen), die Maschinenbefehle entgegen- 
nehmen können und entsprechend deren Kodierung bestimmte Befehle 
ausführen. 


CPU's der heutigen micro-Generation können im allgemeinen 8 bis 
32 Bits mit einem Befehl "bearbeiten! und Speicherräume von 64K 
bis einige Megabyte (1M=1000K) direkt adressieren. 


Cross-Referenz 


In diesem Zusammenhang bedeutet dies eine Tabelle mit Querver- 
weisen aller '"Labels' in einem Assembler-Listing. 


Datei 


Eine Datei ist im allgemeinen eine Zusammenfassung von Daten 
beliebiger Art. Eine Datei wird mit einem Namen versehen, 
der ihren Inhalt bezeichnet und im Normalfall zusätzlich mit 
einem Index, der die Art der Daten angibt. 


Eine Datei im Zusammenhang mit Computern kann z.B. eine Liste von 
Adressen und Telefonnummern sein, aber auch ein ein Assemblerpro- 
gramm, 


Daten 
Unter Daten sind Angaben oder Beschreibungen jeglicher Art zu 
verstehen, die sortiert, geordnet oder sonstwie bearbeitet werden 


können. Daten können als ASCII-Text vorliegen oder in hexadezimal 
bzw. binär verschlüsselt sein. 
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Datumsmarke 


Um in einem Betriebs-System wie CP/M den Zugriff auf Dateien mit 
Uhrzeit und Datum zu vermerken, werden die Dateien im Inhaltsver- 
zeichnis mit einer Datumsmarke versehen. Diese 'Marke' ist zwei- 
geteilt und besteht aus der Uhrzeit (Stunde und Minute) sowie dem 
eigentlichen Datum. Das Datum wird, um damit auch Rechnen zu 
können, als fortlaufende Nummer beginnend von einem bestimmten 
Tage an (bei CP/M 3 ab dem 1.1.1978) abgelegt. Diese Nummer ist 2 
Bytes (=16Bits) groß und hexadezimal verschlüsselt. 


Debugger 


(Engl: bug=sKäfer, Wanze) Es sind darunter Programme zu verstehen, 
mit deren Hilfe es möglich ist Fehler in (neuen) Programmen zu 
suchen, Debugger erlauben es im allgemeinen, die zu untersuchen- 
den Programme Schritt für Schritt, Byte für Byte durchzugehen (zu 
tracen=verfolgen) und dabei die jeweiligen Registerinhalte zu 
ENESTEREREN, um auf diese Art die Ursache eines Fehlverhaltens zu 
finden. 


Default 


(Engl: Vorgabe, vorgegebenes). Dieser Begriff wird unter CP/M vor 
allem im Zusammenhang mit Laufwerken und Paßworten benutzt. Das 
default-Laufwerk ist immer das Laufwerk, auf dem gerade gearbei- 
tet wird, also dessen 'Name' vom CCP im Prompter ausgegeben wird. 


Wird ein Paßwort als "default' gesetzt, so ist darunter zu ver- 
stehen, daß das Betriebs-System sich diese Vorgabe merkt und, 
solange die entsprechende Diskette nicht gewechselt wird, auf 
eine weitere Angabe des Paßwortes beim Diskettenzugriff 
verzichtet, 


Dichte 


Disketten können mit verschiedenen Verfahren beschrieben werden, 
Am Anfang der "Diskettenzeit' wurden alle Disketten mit einem 
Verfahren beschrieben, daß heute "einfache' Dichte heißt. Nachdem 
die Mechanik besser und die Elektronik zuverlässiger wurde, kon- 
nte mit einem neuen Verfahren die doppelte Datenmenge auf den 
gleichen Datenträger geschrieben werden. Dieses Verfahren nannte 
man folgerichtig "doppelte'-Dichte. 


Disassembler 


Ein Disassembler ist, wie der Name schon sagt, das Gegenstück zu 
einem Assembler. Er wandelt den von einem Assembler (oder sonst- 
wie) erzeugten Maschinencode wieder in die leichter "lesbaren' 
Mnemonics zurück. Ein Disassembler ist eines der wichtigsten 
debugger-Hilfsmittel. 


Mit einem Disassembler können Speicherinhalte zwar als Maschinen- 
befehle übersetzt werden, ob es sich dabei aber u.U. um Daten- 
felder oder um Texte handelt, kann der Disassembler nicht 
erkennen. - 
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DMA 


(Engl: Direct-Memory-Access - Direkter-Speicher-Zugriff). Es sind 
darunter zwei Begriffe zu verstehen: 


l. Eine Pufferadresse, wie sie von CP/M verwendet wird und 


2. Ein Hardware-Baustein, der einen schnellen Speicher-zu- 
Speicher Transfer ermöglicht. 


Unter CP/M 3 ist immer der erste Begriff gemeint. 

Editor 

Ein Editor ist ein Programm zur Textbearbeitung. Mit seiner Hilfe 
können Texte geschrieben und korrigiert (editiert) werden. Ein 


Editor ist das wichtigste Werkzeug eines Computers. Editoren 
können in manchen Programmen auch bereits eingebaut sein, 


Eintrag 


Jede Datei, die auf einer Diskette gespeichert ist, wird in einen 
sog. Inhaltsverzeichnis (Engl: Directory) eingetragen. Dieser 
Eintrag umfaßt nicht nur den Namen der Datei, sondern auch An- 
gaben darüber, wo auf der Diskette die Datei abgelegt wurde und 
u.U. zu welcher Zeit und an welchem Tag, 


Extend 


(Engl: Erweiterung) Darunter ist unter CP/M zweierlei zu ver- 
stehen. 


l. die engl. Bezeichnung für den Index einer Datei 
2. die Angabe ob eine Datei aus mehreren Extend im Sinne 
von Teilen (mit jeweils eigenem FCB) besteht, 
FCB 
(Engl: File-Control-Block - Dateien Kontroll Block). Es ist 
unter einem FCB eine Datenstruktur zu verstehen, in welcher 


alle (für CP/M) notwendigen Angaben zu einer Datei abgelegt 
sind. 


File 
(Engl: Datei) siehe dort 


Flag 
(Engl: Flagge) Es ist darunter eine Marke, ein gesetztes Bit o.Ä. 


zu verstehen. Ein Flag dient als Kriterium, ob ein bestimmter, 
gewünschter Vorgang ausgeführt wird oder nicht. 
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Format 


Auf eine Diskette können die Daten in unterschiedlicher Art und 
Weise aufgezeichnet werden. Laufwerksabhängig sind 40, 77 oder 80 
Tracks möglich. Es kann mit einfacher oder doppelter Dichte 
geschrieben werden. Es können Sektorgrößen von 128, 256, 512 oder 
1024 Bytes benutzt und darüberhinaus die Anzahl der Sektoren pro 
Track variiert werden. Auch die Art der Seitenumschaltung und die 
Reservierung der System-tracks spielt eine Rolle. Alle Angaben zu 
den genannten Faktoren bezeichnet man als Format einer Diskette. 


Das Format gibt natürlich auch Auskunft über den ursprünglichen 
Sinn dieses Wortes, ob es sich um eine MIKRO, MINI oder MAXI- 
Diskette handelt. (3,5" 5,25" oder 8"). 


Generieren 


Unter diesem Begriff ist der Vorgang einer Programmaufbe- 
reitung von der Assemblerdatei bis zum ablauffähigen Programm zu 
verstehen. 


Harddisk 


Eine Harddisk entspricht im Prinzip einer Floppy-Disk. In 
diesem Falle ist jedoch das Speichermedium (die Disk) nicht 
austauschbar (sondern hart - Engl: hardshart,fest). Hardisks 
haben im allgemeinen mehrere harte Scheiben (Platten) und 
auch mehrere Köpfe, mit denen gelesen oder geschrieben wird. 
Typische Speichervolumen einer Harddisk für Mikrocomputer 
sind 5..20 MByte. 


Harddisks für Mikrocomputer-Anwendungen werden ebenfalls in 
den Formaten 3.5", 5.25" und 8" geliefert. 


Hardware 


Unter hardware versteht man bei einem Computer alles, was man 
"anfassen' kann, also jeder Baustein, der Bildschirm, die 
Tastatur - eigentlich der ganze Computer, so wie er da steht. 


hexadezimal (sedezimal) 


Computer werden mit Befehlen gesteuert, die aus einzelnen Bits 
bestehen. Da ein Bit nur zweiwertig ist (ja-nein, aus-ein), 
jedoch meist in Gruppen von 8 oder 16 Bits vom Computer benötigt 
wird, ist seine Darstellung zwar recht einfach, das Arbeiten mit 
diesen zweiwertigen Zahlen jedoch recht umständlich, 


Aus diesem Grunde werden die meisten Zahlen und Adressen in 
Computern in Vierergruppen zusammengefaßt und mit der Basis 16 
dargestellt. Die ersten 9 Zahlen entsprechen dabei dem gewohnten 
Bild der dezimalem Zahlenreihe. Die '"zahlen' 10..15 (beginnend 
bei 0!) werden im Hexadezimalsystem mit den Buchstaben A..F 
bezeichent. Die nachfolgende Tabelle soll dies verdeutlichen: 


175 


binär hexadezimal dezimal 


0000 0 0 
0001 1 1 
0010 2 2 
0011 3 3 
0100 4 4 
0101 5 5 
0110 6 6 
o11l 7 7 
1000 8 8 
1001 9 9 
1010 A 10 
1011 B 11 
1100 c 12 
1101 D 13 
1110 E 14 
1111 F 15 


Der Grund, warum gerade die Zahl 16 gewählt wurde, liegt 
ebenfalls in der Zweiwertigkeit. Es sind nur zahlenreihen, die 
eine Potenz der Zahl zwei darstellen möglich, also 2, A, 8, 16, 
32 usw. In älteren Programmen und Zusammenstellungen, wurde der 
Wert 8 als Zahlenbasis (Oktal) verwendet, da in einem 64K System 
Oktalzahlen aber nicht voll "ausgenutzt' werden konnten, wurde 
wieder davon abgegangen. (11111111=oktal 377=hexadezimal ff). 


Hexadezimale Zahlen werden üblicherweise mit einem angehängtem 
'h' oder 'H' gekennzeichnet. Einige Programme "verlangen' ein 
führendes '$'-Zeichen, Hexadezimale Zahlen beginnen üblicherweise 
mit einer Zahl (0..9), einem Buchstaben (A..F) ist eine NULL (0) 
voranzustellen. 


Index 


Zusätzliche Bezeichnung oder "Anhängsel' eines Begriffes. 


Initialisierung 


Wird ein System neu gebootet, so müssen verschiedene Vorgaben 
erfüllt werden, aber auch bestimmte Hardware-Bausteine durch eine 
entsprechende software in einen bestimmten Zustand versetzt wer- 
den. Diesen Vorgang nennt man Initialisierung. 


Interface 


(Engl: face=Gesicht). Man versteht darunter einen physikalischen 
oder logischen Platz, an dem Daten irgendwelcher Art (von Ange- 
sicht zu Angesicht) übergeben werden können. Zwei Beispiel sollen 
dies verdeutlichen: 


Le Einige Bausteine und (nur dies ist für den Benutzer 
erkennbar) ein Stecker dienen dazu (über ein Inter- 
face-Kabel) den Computer mit einem Drucker zu verbinden. 


In diesem Falle spricht man von einem Hardware- (oder 
physikalischen) Interface. 
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2 Die Adresse 0005H in der TPA-Bank eines CP/M-Computers 
wird aufgerufen, wenn bestimmte Befehle vom Betriebs- 
System ausgeführt werden sollen, 


In diesem Falle spricht man von einem Software- (oder 
logischem) Interface. 


Der Punkt an dem zwei Interface-Geräte verbunden werden, nennt 
man 'Schnittstelle',. 


Werden über eine Schnittstelle Signale ausgetauscht, die der 
Steuerung der Zeichenübergabe dienen, spricht man von einer Hand- 
shake-Verbindung. (Engl: Händeschütteln) 


Interrupt 


(Engl: Unterbrechung) Bestimmte Bausteine können den Computer 
veranlassen, seine momentane "Arbeit' zu unterbrechen und eine 
bestimmte Adresse nach weiteren Informationen abzufragen. Diesen 
Vorgang nennt man Interrupt. 


Kompatibel 


Kompatibilität ist nicht unbedingt Gleichheit im Sinne des Aus- 
sehens, sondern Gleichheit im Sinne der Verhaltensweise. So 
können z.B. zwei Disketten völlig gleich aussehen jedoch mit 
unterschiedlichen Formaten beschrieben sein, sie sind damit nicht 
kompatibel; zwei Computer können völlig unterschiedlich aussehen, 
aber beide können unter CP/M Programme auf Disketten austauschen 
und ablaufen lassen, sie sind untereinander kompatibel. 


Konfiguration 


Unter Konfiguration ist die Zusammenstellung Hardware und Soft- 
ware zu verstehen, unter welcher ein Computer in Betrieb genommen 
wird. Hauptsächlich bezieht sich diese Zusammenstellung auf die. 
benutzte hardware; ein oder mehrere Laufwerke, das Disketten- 
format, welche Art der Druckersteuerung wird verwendet und und 
und ... i 


Label sh, = 


(Engl: Etikett) Dieser Begriff hat sich als Bezeichnung .des 
Namens eines Unterprogrammes, einer Konstanten oder einer Variab- 
len in Programmen eingebürgert. Einem Label ist immer ein bestim-. 
mter Wert oder eine bestimmte Adresse zugeordnet, Kon ar TE 


Unter CP/M 3 kann auch einer Diskette ein Label (im Sinne von 
Namen) zugewiesen werden. j 
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Listing 


Listing ist der (vom Assembler veranlaßte) Ausdruck eines in 
Mnemonic's geschriebenen Programmes, das neben dem vom Program- 
mierer geschriebenen Teil auch die vom Assembler decodierten 
Maschinenbefehle und Adressen angibt, 


Der Ausdruck von Programmen in Hochsprachen wie BASIC, PASCAL 
usw. wird heute ebenfalls als Listing bezeichnet, obwohl hier 
keineswegs eine 'Liste der Adressen und Maschinenbefehle' ausge- 
geben wird. 


Logisch 


Unter CP/M wird als logisch bezeichnet, was als Einheit von der 
Software benutzt wird. Die Sektoren einer Diskette z.B. können 
die Größe 128, 256. 512 oder 1024 Bytes haben, unter CP/M wird 
immer mit einer "logischen! Sektorgröße von 128 Bytes gerechnet. 


Das gleiche gilt für Ein- und Ausgabeeinheiten. Ihre "logische" 
Bezeichnung ist z.B. CONIN, ob es sich dabei um die (physikali- 
sche) Einheit einer Tastatur, eines Terminals, eines zweiten 
Computers oder was auch immer, handelt ist dabei völlig unwesent- 
a den das ist Hardware und interessiert das Betriebssystem 
nicht. 


Maschinensprache 


Maschinensprache ist die unterste Ebene der Verständigung Mensch- 
Computer. Jeder Computer wird von einigen hundert Code-"Wörter' 
gesteuert, die jeweils eine ganz bestimmte Aktivität des Com- 
puters veranlassen. 


Menü 


Darstellung der Befehle oder sonstigen Möglichkeiten eines Pro- 
grammes in Form einer Tabelle. Jeder Möglichkeit wird eine Zahl, 
ein Buchstabe oder eine CNTRL-Zeichen zugeordnet. Durch Eingabe 
des entsprechenden Zeichens wird der Befehl ausgeführt oder ein 
entsprechendes Unterprogramm aufgerufen. 


Mnemonic 


(Engl: "Gedächtniskürzel) Anstelle der 'nichtssagenden' Bit- 
Zusammenstellung von Maschinenbefehlen wurden Abkürzungen der 
(englischsprachigen) Befehlsbedeutung eingefürt. Diese neuen 'Be- 
fehlsworte' werden vom Assembler in Maschinensprache übersetzt. 


Modul 


Teil eines Ganzen. Hier meist verwendet als Teil eines Gesamtpro- 

grammes. Ein Modul ist jedoch keinesfalls nur ein Unterprogramm, 

es ist darunter vielmehr die Zusammenfassung mehrere Unterpro- 

gramme zu verstehen, die (meist) alle dem gleichen Aufgabengebiet 

zugewiesen sind. Beispiel sind die Module BIOSKRNL, CHARIO, MOVE, 

lan und BOOT, die zusammen das BIOS eines CP/M 3 System 
den. 
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Modus 


Ein Modus ist die Art und Weise wie etwas geschieht, 


Monitor 


Dieser Begriff ist im Zusammenhang mit Computern zweigeteilt zu. 
verstehen: : 
l. Ein Monitor ist ein Fernsehgerät ohne Fernseh- und Ton- . 
Empfangsteil. Er dient bei einem Computer zur Zeichen- 
Ausgabe, 41 
PN Ein Programm, das die Grundinitialisierung eines;.: 
Computers übernimmt und darüberhinaus die Möglichkeit. 
bietet gewisse Grundfunktionen der Zeichen -Eingabe und 
-Ausgabe zu übernehmen. "Vornehme' Monitorprogramme 
können in gewisser Weise bereits ein (stark abgemager- 
tes) Betriebssystem darstellen, mit eingebautem debug-.,. 
ger, Assembler usw. 


Offset 


Im Zusammenhang mit Computern und Programmen versteht man unter 
einem Offset die '"Entfernung' eines Wertes in einer Tabelle vom. 
Tabellenanfang. Nimmt man z.B. das-Alphabet als Tabelle, so hat 
der Buchstaben 'A' einen Offset von 0, der ‚Buchstaben 'B'.. einen - 
Offset von 1 usw. 


Unter CP/M wird recht häufig mit Tabellen gearbeitet, wobei ein 
bestimmter Buchstaben oder eine Zahl den Offset zu einer Adresse 
bilden. Dies einer der schnellsten Wege des Datenzugriffes bei, 
einer Vielzahl von Daten, ; Bar Eon 


Option er 
Unter Option die frei Entscheidung zu verstehen, ob eine Haglich- 
keit etwas bestimmtes zu tun, ergriffen wird oder nicht. 


Parity 


x ) 
Dies ist ein Begriff aus der atsnbertrasung. üerden “Daten. 
bitweise übertragen, so ist es die einfachste Möglichkeit der 
Fehlerüberprüfung alle (binären) Einsen eines Bytes zu zählen. Je 
nach Art der gewünschten Prüfung wird nach der eigentlichen.,. 
Übertragung ein Kontrollbit gesandt, das auf '1' gesetzt ist, 
wenn die Summe gerade war (even) oder auch wenn sie ungerade war 
(odd). Im jeweils umgekehrten Fall ist das Kontrollbit 79 Big 





Buchstaben und Zeichen, die über die Konsole gesandt uelden, "ange 
üblicherweise nur 7 Bit groß (das gibt immerhin 128 Möglich- „ 
keiten!). Viele Tastaturen und Terminals fügen als 8, „Bit: ein! 
entsprechendes parity-Bit ein. Dieses muß zum reibungslosen; Beni, 
trieb unter CP/M (im BIOS) herausmaskiert werden. Rx 4 


Pen 
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Paßwort 


Mit einem Paßwort (Kennwort) können Dateien unter CP/M 3 vor 
jedem Fremdzugriff geschützt werden. Ein Paßwort besteht im all- 
gemeinen aus einer beliebigen 8-stelligen Ziffern- und Zeichen- 
kombination. 


physikalisch 


Dieser Begriff wird im Zusammenhang mit CP/M 3 im Sinne von 
greifbar. tatsächlich vorhanden benutzt. Es steht im Gegensatz zu 
logisch (siehe auch dort). 


Port 


(Engl: Tor. Türe). Es ist darunter eine Adresse zu verstehen, 
unter welcher auf bestimmte Interface-Bausteine zugegriffen wer- 
den kann. 


Programm 


Ein Programm ist eine sinnvolle Zusammenstellung von Maschinenbe- 
fehlen, die eine bestimmte. vorgegebene "Arbeit' ausführen, 


Prozessor 


Dies ist eine andere Bezeichnung für die CPU. 


RAM-Disk 


Im Gegensatz zur Floppy-Disk und Harddisk, benutzt die RAM-Disk 
normale Speicher (RAM=Random Access Memory - Speicher mit wahl- 
freiem Zugriff). Der Vorteil ist ein schneller Zugriff auf die 
gewünschten Daten; der Nachteil ist es, daß die Daten bei Strom- 
ausfall (oder Abschalten des Gerätes) verloren gehen. Im Zeichen 
des Preisverfalles von CMOS-Speicher, die mit einer Batterie 
gepuffert werden können, bekommen RAM-Disks immer mehr Bedeutung 
als schnelle Zwischen- und Arbeitsspeicher. 


record 

Dieser (englische) Begriff wird verwendet als Bezeichnung von 
logischen oder physikalischen Sektoren oder Blöcken. Im allge- 
meinen bezeichnet er ein Dateiensegment. 

RETURN ’ 

(Engl: Zurück) Bezeichnret ein bestimmtes CNTRL-Zeichen auf der 


Tastatur (Wagenrücklauf=engl: Cariage Return <CR>). Dieses Zei- 
chen dient meist dem Befehlsabschluß. 
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Segment 


Unter Segment ist der Teil eines Ganzen zu verstehen, 


Seitenumschaltung 


Einige Laufwerke (Floppy-Disk) können die Disketten beidseitig 
beschreiben. Welche Seite benutzt werden soll bleibt einem (B1OS- 
Internen) Algorithmus überlassen. 2E 


Eingebürgert haben sich vor allem 3 Methoden: 


l. Alle "geraden' Tracks sind auf Seite 0 (der Vorderseite) 
und "'ungeraden' Tracks auf der Rückseite. Eine sehr ver- 
breitete Methode, da sehr einfach zu realisieren. 


2. Ab einem bestimmten Track wird auf den Anfang der, 
Rückseite umgeschaltet, (z.B. Track 40 oder Track 80). . 
Die Methode des IBM-PC's. 
3. Die Seitenumschaltung erfolgt in Abhängikeit der Sektor- 
nummer. 
Sektor 
Jede Diskette ist in Tracks und Sektoren unterteilt. Die, Tracks 
geben die Position des Schreib- Lesekopfes von außen nach innen 
einer Diskette an. i ı 


Jeder Track ist in verschiedene Segmente unterteilt. Jedes dieser 
Segmente ist (intern) nummeriert und wird als Sektor bezeichnet, 


Software ‚ . orte 





Im Gegensatz zur Hardware ist die Software nicht zum "Anfass en 
sind darunter alle Programme zu verstehen, die dem don ale eine 
sinnvolle Tätigkeit zuweisen, (Unter sinnvoll soll. .hier eng slAch 
ein Programm verstanden werden, daß der Computer 'versteht!} „.., 


Speicher 


Unter Speicher ist jedes Medium zu verstehen, in das computerge- 
recht (also von diesem ansprechbar) Befehle und Daten abgelegt 
werden können. Speicher können Disketten und Kassetten .sein, 
ebenso wie RAM's EPROM's oder PROM'S.. SER I RAR 





string 


(Engl: Kette) Als "'string' bezeichnet man im Computerbereich 
zusammenhängende Zeichenketten. Wird von einem Computer z.B. der 
Satz "guten Tag" ausgegeben, so bilden alle PUEHBERRER GazdRı 
incl. dem Leerzeichen, einen Textstring. : 
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Syntax 


Unter Syntax ist eine bestimmte, vorgegebene Sprachregelung oder 
Anordnung von (Sprach- oder Zeichen-) Elerenten zu verstehen. 


Schreibt die Syntax vor, daß ein Befehl in der Form 
A: tuwas 


eingegeben wird, so wird der Computer nur diese Eingabeform 
akzeptieren und z.B. tuwas A oder Atuwas nicht erkennen. 


System 


Ein System ist die Zusammenstellung verschiedender Software- 
Module die eine bestimmte Aufgabe zusammen mit einer bestimmten 
Hardware erfüllen soll. 


TPA 


(Engl: Transient Program Area - (Speicher)Raum für "Durch-gangs- 
Programme). Hierunter ist der Arbeitsspeicher eines CP/M Systems 
zu verstehen. In diesem Speicherteil 'laufen' alle Programme ab. 


Track 


Siehe hierzu Sektor 


USER 


(Engl: Benutzer) Der Speicherbereich einer Diskette kann in ge- 
wisser Weise in verschiedene (bis zu 16) Ebenen unterteilt wer- 
den. In jeder Ebene können beliebige Dateien abgelegt werden, auf 
die aus einer anderen Ebene nicht zugegriffen werden kann. 


Die Benutzung von USER-Ebenen dient heute vor allem der Disket- 
ten-Organisation und der Übersichtlichkeit in den einzelnen In- 
haltsverzeichnissen. 


Vektor 

Unter Vektor ist im Sprachgebrauch der Computer eine Zeiger im 
allgemeinen Sinne zu verstehen. Dieser Zeiger kann auf ein Byte, 
ein Wort oder eine Adresse hinweisen. Unter CP/M kann ein Vektor 
auch ein Wort enthalten, dessen einzelne Bits bestimmte Systemge- 
gebenheiten signalisieren. 

Wort 


Unter Wort sind (je nach CPU) 2 oder 4 Bytes zu verstehen, ge- 
nauer gesagt 16 oder 32 Bits. Unter CP/M 3 sind es 2 Bytes. 
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Zeitmarke 


Unter zZeitmarke ist die Ablage der Uhrzeit im Inhaltsverzeichnis 
einer Diskette zu verstehen. Mit Zeitmarken wird je nach Anwen-. 
dung die Entstehung einer Datei oder der Zugriff darauf sowie 
jede Veränderung markiert. 


Zeitmarken sind im Übrigen zusammen mit der Datumsmarke ein 
wichtiges Ordnungselement bei der Organistation von Dateien.. 


Zugriff BR 
Wird eine Datei gelesen oder geschrieben, verändert, oder 
gelöscht, spricht man von einem Zugriff (des Betriebs-Systemes), 
auf diese Datei. Zugriffe jeglicher Art können unter CP/M, 3I:mit: 
Datums- und Zeitmarken versehen werden. 


iD 
> 
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Inhaltsverzeichnis der CP/M-Befehls- und Programmbeschreibung 


DIR(S) 22 SETDEV 54 

ERA(SE) 24 SHOW 56 

REN (AME) 26 SUBMIT 58 

TYPE 27 ED 61 
LIB 65 

COPYSYS 30 LINK 67 

DATE 31 (R)MAC 69 

DEVICE 32 PIP 71 

DUMP 35 SID 75 

GENCOM 36 XREF 78 

GET 38 

HELP 39 

HEXCOM al 

INITDIR 43 

PATCH 45 

PUT 46 

SAVE 47 

SET 48 
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Inhaltsübersicht Band II (NDR-Klein-Computer) any he 


Gurt! 
Dieser Band beschäftigt sich mit der Hardware-Anpassung von Fine 
an den NDR-Klein-Computer. 
Es werden ALLE notwendigen Programmsegmente beschrieben incl. äöm 
LOADER-BIOS und der notwendigen Monitor-Anpassung mit ELMON. 


Alle Programme sind mit vollständigen, deutsch kommentierten 
Listings abgedruckt. 


Zusätzlich wird, ebenfalls mit Listing, die Implementation einer 
RAM-Disk, einer software-Uhr und eines sehr flexiblen Formatier- 
ers beschrieben. 


Band II enthält folgende Kapitel: 


Teil IV Die Hardware-Anpassung 


Was bedeutet schon Anpassung ... 
Nach dem Einschalten 

Der Track-0-Lader 

Der CPM-Lader (CPMLDR) 

Das CP/M 3 BIOS - Ein Überblick 
Das BIOS-Kernprogramm und der SCB 
Das BIOS-Segment CHARIO 

Das BIOS-Segment MOVE 

Das BIOS-Segment DISKIO 

Das BIOS-Segment BOOT 
Zuweisungen-Vereinbarungen-Macros 
Generieren der Datei CPM3.SYS 


Teil V Einblicke, Besonderheiten und Ausblicke 
Einblicke auf die Diskette 
nun noch das Besondere - Interrupts und RAM-Floppy 
Ausblicke oder was kommt danach ... 
Teil VI Nützliches 


Die ELMON-Anpassung MONIO 
... Formatieren zum Beispiel 
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